API Overview

TRUE's Certificate API is designed for developers who need to automate credential issuance without wrestling with complexity.

Five endpoints handle everything:

• Create certificates
• Retrieve certificate data
• List issued certificates
• Update certificate status
• Revoke certificates

RESTful architecture means standard HTTP methods, JSON payloads, and predictable responses. If you've integrated any modern API, you already know how to use TRUE.

Blockchain included — every certificate is automatically secured on the blockchain. No additional configuration. No separate calls. Verification data is included in every API response.

Quick Start

Authentication

TRUE uses API key authentication. Include your key in the request header:

`bash curl -X POST https://api.trueoriginal.com/v1/certificates \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{...}' `

API keys are generated in your TRUE dashboard. You can create separate keys for development, staging, and production environments.

Creating a Certificate

Issue a certificate with a single POST request:

`bash curl -X POST https://api.trueoriginal.com/v1/certificates \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "template_id": "tmpl_abc123", "recipient": { "name": "Maria Andersson", "email": "[email protected]" }, "fields": { "course_name": "Advanced Project Management", "completion_date": "2026-03-03", "credential_id": "PM-2026-0042" } }' `

Response:

`json { "id": "cert_xyz789", "status": "issued", "recipient": { "name": "Maria Andersson", "email": "[email protected]" }, "verification_url": "https://verify.yourorg.com/cert_xyz789", "blockchain": { "network": "polygon", "transaction_hash": "0x1234...abcd", "confirmed": true }, "created_at": "2026-03-03T09:15:00Z" } `

The certificate is created, blockchain-secured, and the recipient receives it via email — all from one API call.

Retrieving a Certificate

`bash curl -X GET https://api.trueoriginal.com/v1/certificates/cert_xyz789 \ -H "Authorization: Bearer YOUR_API_KEY" `

Returns full certificate data including blockchain verification status, view analytics, and share tracking.

Integration Guides

TRUE integrates with the platforms your organization already uses.

Salesforce

Trigger certificate issuance when opportunities close, training completes, or certifications are earned.

Integration approach:

1. Create a Connected App in Salesforce
2. Build an Apex trigger or Process Builder flow
3. Call TRUE API on qualifying events
4. Store certificate IDs back to Salesforce records

Example trigger scenario: When a Contact completes a training program (custom field updated), issue a certificate and link it to their record.

`apex // Simplified Apex example HttpRequest req = new HttpRequest(); req.setEndpoint('https://api.trueoriginal.com/v1/certificates'); req.setMethod('POST'); req.setHeader('Authorization', 'Bearer ' + trueApiKey); req.setHeader('Content-Type', 'application/json'); req.setBody(JSON.serialize(certificatePayload)); `

Canvas LMS

Issue certificates automatically when students complete courses or achieve mastery.

Integration approach:

1. Configure Canvas webhook for course completion events
2. Build middleware to receive webhooks and call TRUE API
3. Map Canvas user data to certificate fields
4. Optionally post certificate link back to Canvas

Canvas webhook payload includes: User ID, Course ID, completion timestamp — everything needed to populate a certificate.

Moodle

Automate credential issuance based on course completion, quiz scores, or custom completion criteria.

Integration approach:

1. Use Moodle's event system (course_completed, quiz_passed)
2. Build a local plugin or external webhook handler
3. Transform Moodle event data to TRUE API format
4. Issue certificates and store verification URLs in Moodle user profiles

Learnster

Connect Learnster's completion events to TRUE for seamless credentialing.

Integration approach:

1. Configure Learnster completion webhooks
2. Map Learnster learner data to certificate recipient fields
3. Issue certificates on course or program completion
4. Track credential analytics alongside learning analytics

Bulk Operations

Issuing hundreds or thousands of certificates? TRUE handles bulk operations efficiently.

Batch Endpoint

`bash curl -X POST https://api.trueoriginal.com/v1/certificates/batch \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "template_id": "tmpl_abc123", "recipients": [ {"name": "Anna Svensson", "email": "[email protected]", "fields": {...}}, {"name": "Erik Lindqvist", "email": "[email protected]", "fields": {...}}, ... ] }' `

Response: Batch job ID for tracking progress.

Batch Status

`bash curl -X GET https://api.trueoriginal.com/v1/batches/batch_123 \ -H "Authorization: Bearer YOUR_API_KEY" `

Returns: total count, completed count, failed count, and individual certificate IDs.

CSV Alternative

For teams without development resources, TRUE accepts CSV uploads through the dashboard. Same automation, no code required.

Email-Based Issuance

Not every workflow needs API integration. TRUE's email-based issuance offers automation without development work.

How it works:

1. Configure an email template in TRUE dashboard
2. Send structured emails to TRUE's issuance address
3. TRUE parses recipient data from email content
4. Certificates are issued and delivered automatically

Use case: Trigger certificate issuance from systems that can send email but lack API capabilities (legacy HR systems, simple form tools, manual processes).

Webhooks

TRUE sends webhook notifications when certificate events occur.

Supported events:

• certificate.issued — Certificate created and blockchain-confirmed
• certificate.viewed — Recipient or third party viewed certificate
• certificate.shared — Certificate shared to LinkedIn or embedded
• certificate.verified — Someone verified the certificate via QR/portal
• certificate.revoked — Certificate revoked

Webhook payload:

`json { "event": "certificate.viewed", "certificate_id": "cert_xyz789", "timestamp": "2026-03-03T10:30:00Z", "data": { "viewer_location": "Stockholm, SE", "referrer": "linkedin.com" } } `

Configure webhook endpoints in your TRUE dashboard. TRUE supports multiple endpoints and filters by event type.

Technical Specifications

Rate Limits

| Plan | Requests/minute | Batch size | |------|-----------------|------------| | Standard | 60 | 100 | | Professional | 300 | 500 | | Enterprise | Custom | Custom |

Rate limit headers included in every response:

• X-RateLimit-Limit
• X-RateLimit-Remaining
• X-RateLimit-Reset

Error Handling

TRUE returns standard HTTP status codes with detailed error messages:

`json { "error": { "code": "invalid_template", "message": "Template tmpl_invalid does not exist or is not active", "documentation_url": "https://docs.trueoriginal.com/errors/invalid_template" } } `

Common status codes:

• 200 Success
• 201 Created
• 400 Bad request (validation error)
• 401 Unauthorized (invalid API key)
• 404 Not found
• 429 Rate limit exceeded
• 500 Server error

Security

• TLS 1.3 required for all connections
• API keys are scoped by environment and revocable
• IP allowlisting available for enterprise accounts
• Audit logs track all API activity

Use Cases

Automated Graduation Ceremonies

Universities and vocational schools issue hundreds of diplomas on graduation day. API integration automates the entire flow:

1. Student information system marks students as graduated
2. Webhook triggers certificate issuance
3. Graduates receive blockchain-secured diplomas instantly
4. Verification links are recorded in student records

Result: No manual processing. No printing delays. Graduates share their credentials on LinkedIn the same day.

Compliance Training

Organizations must track and credential compliance training. API integration ensures credentials follow completion:

1. LMS marks training as complete
2. API call issues certificate with training details
3. Certificate includes expiration date if applicable
4. HR system receives webhook confirming issuance
5. Analytics track when certificates are verified by auditors

Result: Audit-ready records. No manual certificate creation. Automatic reminders before expiration.

Course Completion

Online learning platforms need seamless credentialing. Every course completion triggers:

1. Platform detects completion criteria met
2. API issues personalized certificate
3. Learner receives shareable credential
4. Platform analytics track engagement boost from shared certificates

Result: Learners get credentials instantly. Every share drives traffic and enrollments.

Why TRUE's API

Simplicity

Five endpoints. That's the entire API surface. Competitors require dozens of endpoints, complex authentication flows, and extensive configuration. TRUE's API is designed to work in hours, not weeks.

Blockchain Built In

Blockchain verification isn't a separate module or additional cost. Every API-issued certificate is automatically secured on Ethereum, Polygon, AVAX, or Fantom. Verification data is included in every response.

Custom Domain

Certificates issued via API live on your domain — credentials.yourorg.com — not on TRUE's website. Configure once, and all API-issued certificates use your branding and domain.

Developer Experience

Clear documentation. Consistent responses. Helpful error messages. Sandbox environment for testing. TRUE's API is built by developers who integrate APIs themselves and know what matters.

Getting Started

Step 1: Request API access through your TRUE dashboard or contact us.

Step 2: Create certificate templates with your branding and required fields.

Step 3: Generate API keys for your environments.

Step 4: Build your integration using our documentation and examples.

Step 5: Test in sandbox mode before going live.

Step 6: Issue blockchain-secured certificates at scale.

Most integrations go live within one to two weeks.

What programming languages are supported?

TRUE's REST API works with any language that can make HTTP requests. Documentation includes examples in curl, JavaScript, Python, and PHP.

Is there a sandbox environment?

Yes. Sandbox API keys let you test the full API without issuing real certificates or consuming production quotas.

What happens if the API is down?

TRUE's API has 99.9% uptime SLA for enterprise accounts. Webhook retries handle temporary failures automatically. Status page at status.trueoriginal.com tracks availability.

Can I customize certificates via API?

Yes. API requests can populate any field defined in your certificate templates — names, dates, course titles, credential IDs, custom data.

How do I get API keys?

API access is included in TRUE subscriptions. Generate keys from your dashboard or contact us to enable API access on your account.

Ready to Automate Certificate Issuance?

TRUE's API turns manual credential work into automated workflows. Five endpoints. Blockchain included. Integration in days.

Get API Keys — Contact us to enable API access and start building.

→ Get API Keys

Want to see the technical details first? Read the full API documentation.

→ API Documentation