Skip to content
/
Envelope rejected

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

Envelope signed & completeWebhook

Request

This webhook is triggered when all required parties have completed signing an envelope. It includes the envelope fingerprint, documents, any captured field data, and a download link.

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

A string representing the signed envelope

Example: "584ea8b41b0d4c17a96b967433b211e6"
envelope_documentsstringrequired

A JSON string representing the signed documents within the envelope

Example: "[{\"document_title\":\"Word Doc\",\"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 completed envelope

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

A JSON string of captured field values within the envelope

Example: "[{\"field_id\":460133805,\"field_name\":\"Untitled\",\"field_type\":\"text\",\"field_value\":\"Test\"}]"
envelope_metastring

A JSON string of any meta information associated with the envelope

Example: ""
actionstringrequired

The action taken. Defaults to signed-envelope-complete.

Example: "signed-envelope-complete"
action_datestring(date-time)required

The UTC timestamp of when the envelope was fully signed

Example: "2025-08-07T10:14:33+00:00"
company_idintegerrequired

The ID of the company associated with the envelope

Example: 64034
user_idintegerrequired

The ID of the user who sent or owns the envelope

Example: 267199
client_ipstring(ipv4)required

The IP address of the client that triggered the completion

Example: "203.0.113.17"
application/x-www-form-urlencoded
envelope_fingerprint=584ea8b41b0d4c17a96b967433b211e6&envelope_documents=%5B%7B%22document_title%22%3A%22Word%20Doc%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_fields=%5B%7B%22field_id%22%3A460133805%2C%22field_name%22%3A%22Untitled%22%2C%22field_type%22%3A%22text%22%2C%22field_value%22%3A%22Test%22%7D%5D&envelope_meta=&action=signed-envelope-complete&action_date=2025-08-07T10%3A14%3A33%2B00%3A00&company_id=64034&user_id=267199&client_ip=203.0.113.17

Responses

Acknowledge receipt

Envelope rejectedWebhook

Request

This webhook is triggered when a recipient rejects an envelope. It includes details about the envelope, the rejecting contact, and relevant metadata.

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

The action taken. Defaults to rejected-envelope.

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

The UTC timestamp of when the action occurred

Example: "2025-08-07T11:10:39+00:00"
envelope_fingerprintstringrequired

A string representing the rejected envelope

Example: "584ea8b41b0d4c17a96b967433b211e6"
document_idintegerrequired

The ID of the document that was rejected

Example: 0
document_titlestringrequired

The title of the rejected document

Example: "Word Doc"
contact_idintegerrequired

The ID of the contact who rejected the envelope

Example: 7418454
contact_namestringrequired

The name of the contact who rejected the envelope

Example: "Abby"
contact_emailstring(email)required

The email address of the contact who rejected the envelope

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

A fingerprint identifying the signature session that triggered the rejection

Example: "584ea8b41b0d4c17a96b967433b211e6"
envelope_metastring

A JSON string of any meta information added to the envelope

Example: ""
client_ipstring(ipv4)required

The IP address from which the rejection was submitted

Example: "203.0.113.42"
application/x-www-form-urlencoded
action=rejected-envelope&action_date=2025-08-07T11%3A10%3A39%2B00%3A00&envelope_fingerprint=584ea8b41b0d4c17a96b967433b211e6&document_id=0&document_title=Word%20Doc&contact_id=7418454&contact_name=Abby&contact_email=abby%40signable.co.uk&signature_fingerprint=584ea8b41b0d4c17a96b967433b211e6&envelope_meta=&client_ip=203.0.113.42

Responses

Acknowledge receipt

Envelope openedWebhook

Request

This webhook is triggered when a recipient opens an envelope. It includes basic information about the envelope, the recipient, and associated documents.

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

The action taken. Defaults to opened-envelope.

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

The UTC timestamp of when the envelope was opened

Example: "2025-08-07T10:14:26+00:00"
company_idintegerrequired

The ID of the company that owns the envelope

Example: 64034
contact_idintegerrequired

The ID of the contact who opened the envelope

Example: 7418454
contact_namestringrequired

The name of the contact who opened the envelope

Example: "Abby"
contact_emailstring(email)required

The email address of the contact who opened the envelope

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

A string identifying the opened envelope

Example: "584ea8b41b0d4c17a96b967433b211e6"
envelope_documentsstringrequired

A stringified JSON array of documents in the envelope

Example: "[{\"document_title\":\"Blank Word Doc\",\"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 download link for the entire envelope

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

A JSON string of any meta information added to the envelope

Example: ""
user_idintegerrequired

The ID of the user associated with this event

Example: 267199
client_ipstring(ipv4)required

The IP address from which the envelope was opened

Example: "203.0.113.106"
application/x-www-form-urlencoded
action=opened-envelope&action_date=2025-08-07T10%3A14%3A26%2B00%3A00&company_id=64034&contact_id=7418454&contact_name=Abby&contact_email=abby%40signable.co.uk&envelope_fingerprint=584ea8b41b0d4c17a96b967433b211e6&envelope_documents=%5B%7B%22document_title%22%3A%22Blank%20Word%20Doc%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_meta=&user_id=267199&client_ip=203.0.113.106

Responses

Acknowledge receipt