Skip to content
/
List webhooks

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

List webhooks

Request

Retrieves a paginated list of all webhooks currently registered to receive event notifications. Supports offset and limit for pagination. Webhooks include metadata about creation, update, and suspension state.

Security
basicAuth
Query
offsetinteger

Pagination offset

Example: offset=0
limitinteger

Number of webhooks to return

Example: limit=10
curl -i -X GET \
  -u <username>:<password> \
  'https://developers.signable.app/_mock/openapi/webhooks?offset=0&limit=10'

Responses

Successfully returned a list of webhooks

Bodyapplication/json
httpintegerrequired
Example: 200
offsetintegerrequired
Example: 10
limitintegerrequired
Example: 10
total_webhooksstringrequired
Example: "44"
nextstring(uri)
Example: "https://api.signable.co.uk/v1/webhooks?offset=10&limit=10"
webhooksArray of objects(WebhookListItem)required
webhooks[].​webhook_idstringrequired

Unique identifier of the webhook

Example: "132223"
webhooks[].​webhook_urlstring(uri)required

The URL to which webhook events are sent

Example: "https://example.com"
webhooks[].​webhook_typestringrequired

The type of event the webhook listens for

Enum"send-envelope""signed-envelope""cancelled-envelope""rejected-envelope""bounced-envelope""add-user""add-contact""opened-envelope""add-template""all"
Example: "send-envelope"
webhooks[].​webhook_createdstring(date-time)required

Timestamp when the webhook was created

Example: "2025-06-23T17:15:01+0000"
webhooks[].​webhook_updatedstring or nullrequired

When the webhook was last updated

Example: null
Any of:

When the webhook was last updated

string(date-time)

When the webhook was last updated

webhooks[].​webhook_suspendedstring or nullrequired

When the webhook was suspended (or null if active)

Example: null
Any of:

When the webhook was suspended (or null if active)

string(date-time)

When the webhook was suspended (or null if active)

Response
application/json
{
  "http": 200,
  "offset": 10,
  "limit": 10,
  "total_webhooks": "44",
  "next": "https://api.signable.co.uk/v1/webhooks?offset=10&limit=10",
  "webhooks": [
    { … },
    { … },
    { … }
  ]
}

Create a webhook

Request

Registers a new webhook that will be triggered when a specific event occurs. You must provide a valid webhook_url and a supported webhook_type. The created webhook will immediately be eligible to receive matching notifications.

Security
basicAuth
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 POST \
  -u <username>:<password> \
  https://developers.signable.app/_mock/openapi/webhooks \
  -H 'Content-Type: application/json' \
  -d '{
    "webhook_url": "https://example.com/webhook",
    "webhook_type": "send-envelope"
  }'

Responses

Webhook successfully created

Headers
Locationstring(uri)

The URL of the newly created webhook resource

Bodyapplication/json
httpintegerrequired

HTTP status code

Example: 200
messagestringrequired

Confirmation message about the webhook creation

Example: "The webhook (https://example.com) has been created"
hrefstring(uri)required

API resource URL for the newly created webhook

Example: "https://api.signable.co.uk/v1/webhooks/152691"
webhook_idstringrequired

Unique identifier for the created webhook

Example: "152691"
webhook_urlstring(uri)required

The callback URL registered for the webhook

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

The event type the webhook is subscribed to

Enum"send-envelope""signed-envelope""cancelled-envelope""rejected-envelope""bounced-envelope""add-user""add-contact""opened-envelope""add-template""all"
Example: "all"
webhook_createdstring(date-time)required

The timestamp when the webhook was created

Example: "2025-06-23T17:15:01+0000"
Response
application/json
{
  "http": 200,
  "message": "The webhook (https://example.com) has been created",
  "href": "https://api.signable.co.uk/v1/webhooks/152691",
  "webhook_id": "152691",
  "webhook_url": "https://example.com",
  "webhook_type": "all",
  "webhook_created": "2025-06-23T17:15:01+0000"
}

Get a webhook

Request

Retrieves details of a specific webhook by its unique webhook_id. The response includes the current status and metadata of the webhook.

Security
basicAuth
Path
webhook_idintegerrequired

The ID of the webhook to retrieve

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

Responses

Webhook details returned successfully

Bodyapplication/json
httpintegerrequired

HTTP status code

Example: 200
webhook_idintegerrequired

Unique identifier of the webhook

Example: 152691
webhook_urlstring(uri)required

The URL to which webhook events are sent

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

Type of event the webhook listens for

Enum"send-envelope""signed-envelope""cancelled-envelope""rejected-envelope""bounced-envelope""add-user""add-contact""opened-envelope""add-template""all"
Example: "all"
webhook_createdstring(date-time)required

Timestamp when the webhook was created

Example: "2025-06-23T17:15:01+0000"
webhook_updatedstring or nullrequired

Timestamp when the webhook was last updated

Example: null
Any of:

Timestamp when the webhook was last updated

string(date-time)

Timestamp when the webhook was last updated

webhook_suspendedboolean or nullrequired

Whether the webhook is currently suspended

Example: null
Any of:

Whether the webhook is currently suspended

boolean

Whether the webhook is currently suspended

Response
application/json
{
  "http": 200,
  "webhook_id": 152691,
  "webhook_url": "https://example.com",
  "webhook_type": "all",
  "webhook_created": "2025-06-23T17:15:01+0000",
  "webhook_updated": null,
  "webhook_suspended": null
}