Notifications object
You can subscribe to notifications which will be sent to a specified endpoint. This endpoint will need to be publicly accessible.
"notifications": { "destination": "https://mysite.com/events", "subscriptions": [ "envelope_completion", "envelope_ready", "signer_completion", "upload_errors", "sign_offline_upload_errors", "idv_resource_update", "idv_session_completion", "idv_check_completion", "idv_task_completion", "idv_session_limit_reached" ] }| Parameter | Description |
|---|---|
| destination | Endpoint for notifications to be sent to. Only HTTPS endpoints with TLS 1.2 are supported. |
| envelope_completion | When all recipients have signed the document. |
| envelope_ready | The document is sealed. |
| envelope_created | The document is sealed.
|
| signer_completion | The signer has signed. |
| upload_errors | When there is an error in the envelope creation process. |
| sign_offline___upload_errors | When there is an error in the process of uploading a document that was signed offline. |
| idv_resource_update | Specific to envelopes with an Identity verification check enabled. Update received whenever there are changes to resources in the IDV session. For example, a user uploading a new document. |
| idv_session_completion | Specific to envelopes with an Identity verification check enabled. Triggered when all tasks and all checks inside of a given session have been completed. |
| idv_check_completion | Specific to envelopes with an Identity verification check enabled. Sent when a check completes – for example a document authenticity check being performed. |
| idv_task_completion | Specific to envelopes with an Identity verification check enabled. Sent when a task is completed. If you require TEXT_EXTRACTION and the check has been fulfilled, Yoti will send this through as an update to your endpoint. |
| idv_session_limit_reached | Specific to envelopes with an Identity verification check enabled. When a recipient has reached their session limit. You can use the reset session limit endpoint to if you want the recipient to try again |
Example Notifications
{ "envelope_id": "10aecb06-d50d-4f54-9e99-a85b63639837", "status": "COMPLETE", "platform": { "type": "API" }, "marked_for_deletion": false, "details": { "recipients": [ { "id": "73a527f5-e217-4fa8-a47f-4c829892f722", "name": "User3", "email": "example3@gmail.com", "type": "CC", "tags": [], "invitation_email_queued_at": "", "sign_group_order": "", "last_email_status": "SENT" }, { "id": "5b449856-c56d-464a-8fd4-32fe383a9745", "sign_status": "SIGNED", "name": "User2", "email": "example2@gmail.com", "auth_type": "no-auth", "type": "WITNESS", "tags": [ { "name": "6f8313c1-f43f-4b6b-acab-4a1eda523604", "tag_group_name": "", "was_optional": false, "value": "true" } ], "invitation_email_queued_at": "", "sign_group_order": 1, "role": "Witness", "signed_at": "2024-12-18T11:52:43.475Z", "ip_address": "83.217.238.208", "signer_id": "b8d4c176-9bf5-4c9c-a7c1-e7d41557bdb5", "last_email_status": "SENT" }, { "id": "b8d4c176-9bf5-4c9c-a7c1-e7d41557bdb5", "sign_status": "SIGNED", "name": "User1", "email": "example@gmail.com", "auth_type": "no-auth", "type": "SIGNER", "tags": [ { "name": "29784733-b0de-4a1c-9e84-bee7b2ddce0f", "tag_group_name": "", "was_optional": false, "value": "d" }, { "name": "1a71be9c-05cd-4c8e-999c-5b2d55504053", "tag_group_name": "", "was_optional": false, "value": "true" } ], "invitation_email_queued_at": "", "sign_group_order": 1, "role": "Tenant 1", "signed_at": "2024-12-18T11:52:18.710Z", "ip_address": "83.217.238.208", "last_email_status": "SENT" } ], "completed_at": "2024-12-18T11:52:43.475Z", "files": [ { "id": "357e8d9c-9b9f-4057-9c84-42a322d059d1", "name": "blankPDF.pdf" } ] }, "subscription_name": "envelope_completion", "envelope_name": "Example-Envelope"}Was this page helpful?