Webhooks

SignumEra reserves OAuth scope support for webhook management, allowing applications to receive asynchronous notifications about signing activity and other API events.

OAuth Scope

webhooks.manage

Public webhook registration and delivery endpoints are not currently exposed by the SignumEra v1 API.

Current API Behaviour

Applications should currently monitor signing-request state using:

GET /api/v1/signing-requests/{id}

This endpoint returns the current ceremony status, document state, evidence readiness and ceremony timestamps.

{
    "id": "REQUEST_ID",
    "submission_status": "accepted",
    "status": "in_progress",
    "document": {
        "status": "prepared"
    },
    "evidence": {
        "ready": false
    },
    "prepared_at": "2026-10-03T14:30:00Z",
    "opened_at": "2026-10-03T14:31:00Z",
    "finalized_at": null
}

Planned Webhook Support

The webhooks.manage OAuth scope is reserved for future webhook endpoint registration and delivery management.

Webhook endpoint URLs, event types, signing secrets and delivery behaviour should not be assumed until the public webhook API is released.