Developers
The full platform, also as an API.
Issue documents, create signing envelopes, listen for events via signed webhooks and embed the signing ceremony in your own application. Everything you see in the dashboard exists first as an API.
Versioned REST API
- Everything the dashboard does can be done via API (/api/v1, OpenAPI/Swagger).
- API keys and service accounts with granular per-key permissions.
- Strict multi-tenancy: each key operates only within its organization.
- Consistent errors with code, message and correlation ID.
Signed webhooks
- Lifecycle events: agreement sent, signed, completed, declined, expired…
- Stripe-style HMAC-SHA256 signatures with anti-replay protection.
- Retries with exponential backoff and classified idempotency.
- Manage subscriptions and secrets from the dashboard or the API.
Embedded signing
- Embed the signing ceremony in your app with an iframe.
- Single-use ephemeral sessions created server-side (15-minute TTL).
- Your app asserts identity; Certums records the act and the evidence.
- postMessage on completion so your flow continues without a reload.
Programmatic verification
- Public verification of documents by CSV and agreements by URL — no authentication.
- Exportable evidence package: verify offline with SHA-256, without depending on Certums.
- Published Ed25519 public keys to validate platform seals.
- Public forms with self-initiated signing, ready to link from your site.
Example
# Create and send an agreement for signing
curl -X POST https://api.certums.com/api/v1/agreements \
-H "Authorization: Bearer $CERTUMS_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Contrato de servicios",
"flowMode": "sequential",
"documents": [{ "documentId": "<docId>", "title": "Contrato" }],
"participants": [
{ "ref": "p1", "role": "signer", "name": "Ana Pérez",
"email": "[email protected]", "order": 1 }
],
"fields": [
{ "type": "signature", "participantRef": "p1", "documentId": "<docId>",
"page": 1, "rect": { "x": 0.55, "y": 0.85, "w": 0.3, "h": 0.07 } }
]
}' Need API credentials? Create your workspace and generate API keys from the dashboard, or contact us for guided onboarding.