Create envelopes with embedded signing and retrieve signing page URLs.
- Embedded signing enabled on your account
- Signable API credentials
- Webhook endpoint configured (for multi-party envelopes)
Send a POST request to create an envelope:
POST https://api.signable.co.uk/v1/envelopesInclude your document (template ID or base64-encoded file) and signer details in the request body.
When embedded signing is enabled on your account, the API response includes the envelope_signing_embed field containing the signing page URL.
How you retrieve the signing URL depends on your envelope type.
For envelopes with one signer, extract the signing URL directly from the API response:
{
"envelope_signing_embed": "https://app.signable.co.uk/sign/..."
}Set up webhooks in your Signable account:
- Go to your API settings
- Add your webhook endpoint URL
- Enable the
envelope-sentwebhook - Enable the
signed-envelopewebhook (for multi-party envelopes)
Your endpoint must return a 2xx HTTP status to confirm receipt.
The webhook payload includes the signing URL:
{
"envelope_signing_embed": "https://app.signable.co.uk/sign/..."
}Extract this value and deliver it through your chosen channel.
After retrieving the signing URL, deliver it to your signer:
- Application embedding: Display the URL in an iframe or redirect
- Custom email: Include the URL in your email template
- SMS: Send the URL in a text message
When all signers complete the envelope, Signable sends completion emails with signed documents to all parties.
Use the signed-envelope webhook to trigger actions in your system when signing completes.