Skip to content
/
Delete a webhook

Signable API (1.0.0)

The Signable API provides secure and efficient access to Signable's electronic signature platform. With this RESTful API, you can send documents for signature, manage templates, track envelope status, and automate your document workflows from within your own applications.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
Signable

help@signable.co.uk

License

Proprietary

Terms of Service

Languages
Servers
Mock server

https://developers.signable.app/_mock/openapi/

Production server

https://api.signable.co.uk/v1/

Partners

Manage partner integrations.

Operations

Envelopes

Send, track, and manage documents for e-signature.

Operations

Templates

Create and reuse predefined document templates.

Operations

Contacts

Manage contact details for signers and stakeholders.

Operations

Users

Control user accounts and roles.

Operations

Branding

Customize visual and branding settings for emails.

Operations

Settings

Configure account-wide preferences and defaults.

Operations

Webhooks

Receive real-time notifications about document events.

OperationsWebhooks

Update a webhook

Request

Updates the webhook identified by webhook_id. You may change thewebhook_url and/or the webhook_type.

Security
basicAuth
Path
webhook_idintegerrequired

The ID of the webhook to update

Example: 152691
Bodyapplication/jsonrequired
webhook_urlstring(uri)required

The callback URL where webhook events will be sent.

Example: "https://example.com"
webhook_typestringrequired

The event type to subscribe to.

Enum"send-envelope""signed-envelope""cancelled-envelope""rejected-envelope""bounced-envelope""add-user""add-contact""opened-envelope""add-template""all"
Example: "send-envelope"
curl -i -X PUT \
  -u <username>:<password> \
  https://developers.signable.app/_mock/openapi/webhooks/152691 \
  -H 'Content-Type: application/json' \
  -d '{
    "webhook_url": "https://example.com/webhook",
    "webhook_type": "send-envelope"
  }'

Responses

Webhook updated successfully

Bodyapplication/json
httpintegerrequired
Example: 200
messagestringrequired
Example: "The webhook with ID 152691 has been updated"
hrefstring(uri)required
Example: "https://api.signable.co.uk/v1/webhooks/152691"
webhook_idintegerrequired
Example: 152691
webhook_urlstring(uri)required
Example: "https://abby-example.com"
webhook_typestringrequired
Enum"send-envelope""signed-envelope""cancelled-envelope""rejected-envelope""bounced-envelope""add-user""add-contact""opened-envelope""add-template""all"
Example: "all"
webhook_updatedstring(date-time)required
Example: "2025-06-24T09:32:55+0000"
Response
application/json
{
  "http": 200,
  "message": "The webhook with ID 152691 has been updated",
  "href": "https://api.signable.co.uk/v1/webhooks/152691",
  "webhook_id": 152691,
  "webhook_url": "https://abby-example.com",
  "webhook_type": "all",
  "webhook_updated": "2025-06-24T09:32:55+0000"
}

Delete a webhook

Request

Deletes the webhook identified by webhook_id. Once removed, the webhook will no longer receive event notifications.

Security
basicAuth
Path
webhook_idintegerrequired

The ID of the webhook to delete

Example: 152691
curl -i -X DELETE \
  -u <username>:<password> \
  https://developers.signable.app/_mock/openapi/webhooks/152691

Responses

Webhook successfully deleted

Bodyapplication/json
httpintegerrequired

HTTP status code

Example: 200
messagestringrequired

Descriptive message confirming the webhook was removed

Example: "The webhook (https://abby-example.com) has been removed from your account."
webhook_idintegerrequired

Unique identifier of the deleted webhook

Example: 152691
webhook_urlstring(uri)required

The URL of the deleted webhook

Example: "https://abby-example.com"
webhook_typestringrequired

Type of event the deleted webhook was subscribed to

Enum"send-envelope""signed-envelope""cancelled-envelope""rejected-envelope""bounced-envelope""add-user""add-contact""opened-envelope""add-template""all"
Example: "all"
Response
application/json
{
  "http": 200,
  "message": "The webhook (https://abby-example.com) has been removed from your account.",
  "webhook_id": 152691,
  "webhook_url": "https://abby-example.com",
  "webhook_type": "all"
}

Envelope sentWebhook

Request

This webhook is triggered after an envelope has been successfully processed and sent. It delivers information about the envelope, the recipient, any additional metadata, and a download URL.

Security
basicAuth
Bodyapplication/x-www-form-urlencodedrequired
envelope_fingerprintstringrequired

A string representing the envelope that was sent

Example: "584ea8b41b0d4c17a96b967433b211e6"
envelope_documentsstringrequired

A JSON string representing the documents within the envelope

Example: "[{\"document_title\":\"Untitled document\",\"document_fingerprint\":\"584ea8b41b0d4c17a96b967433b211e6\",\"document_pdf\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\",\"document_download\":\"https://api.signableapi.com/shareable/document?t=03cbb315-4f68-400d-a5cc-c2884996d061\"}]"
envelope_downloadstring(uri)required

A URL to download the envelope contents

Example: "https://api.signableapi.com/shareable/envelope?t=03cbb315-4f68-400d-a5cc-c2884996d061"
contact_idintegerrequired

The ID of the contact the envelope was sent to

Example: 14029945
contact_namestringrequired

The name of the contact the envelope was sent to

Example: "Abby Smith"
contact_emailstring(email)required

The email address of the contact the envelope was sent to

Example: "abby@signable.co.uk"
actionstringrequired

The action taken. Defaults to send-envelope.

Example: "send-envelope"
action_datestring(date-time)required

The UTC timestamp of when the action occurred

Example: "2025-06-20T15:50:10+00:00"
envelope_metastring

A JSON string of any meta information added when sending the envelope

Example: ""
envelope_signing_embedstring

An iframe URL for embedded signing, if enabled

Example: "<iframe src=\"https://sign.signable.app/#2KnUUnVQTxtkpV8rmWqem9qXpvaTU2hYLHHyQD7WtdQ\" width=\"100%\" height=\"95%\" frameborder=\"0\" style=\"border: 0; overflow: hidden\"></iframe>"
application/x-www-form-urlencoded
envelope_fingerprint=584ea8b41b0d4c17a96b967433b211e6&envelope_documents=%5B%7B%22document_title%22%3A%22Untitled%20document%22%2C%22document_fingerprint%22%3A%22584ea8b41b0d4c17a96b967433b211e6%22%2C%22document_pdf%22%3A%22https%3A%2F%2Fapi.signableapi.com%2Fshareable%2Fdocument%3Ft%3D03cbb315-4f68-400d-a5cc-c2884996d061%22%2C%22document_download%22%3A%22https%3A%2F%2Fapi.signableapi.com%2Fshareable%2Fdocument%3Ft%3D03cbb315-4f68-400d-a5cc-c2884996d061%22%7D%5D&envelope_download=https%3A%2F%2Fapi.signableapi.com%2Fshareable%2Fenvelope%3Ft%3D03cbb315-4f68-400d-a5cc-c2884996d061&envelope_signing_embed=%3Ciframe%20src%3D%22https%3A%2F%2Fsign.signable.app%2F%232KnUUnVQTxtkpV8rmWqem9qXpvaTU2hYLHHyQD7WtdQ%22%20width%3D%22100%25%22%20height%3D%2295%25%22%20frameborder%3D%220%22%20style%3D%22border%3A%200%3B%20overflow%3A%20hidden%22%3E%3C%2Fiframe%3E&contact_id=14029945&contact_name=Abby%20Smith&contact_email=abby%40signable.co.uk&action=send-envelope&action_date=2025-06-20T15%3A50%3A10%2B00%3A00&envelope_meta=

Responses

Acknowledge receipt