Send an envelope with embedded signing

Create envelopes with embedded signing and retrieve signing page URLs.

• Embedded signing enabled on your account.

  Authentication

  This is what makes the envelope_signing_embed field appear in API responses and webhook payloads. Without it, no signing URL is returned. Contact Signable support to enable.

• Signable API credentials.

• A webhook endpoint that returns a 2xx HTTP status. Required for multi-party envelopes and for any envelope created from an uploaded file (see Retrieve the signing URL).

Send a POST request to create an envelope:

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

Include your document and signer details in the request body. You can supply the document either as a template ID or as a base64-encoded file.

Note: The envelope_signing_embed field is only returned when embedded signing is enabled on your account. If you don't see it in the response or webhook payload, check that embedded signing is active before troubleshooting anything else.

The signing URL is always returned in the envelope_signing_embed field. Where you read that field from depends on how you created the envelope:

• One signer, created from a template: the field is in the create-envelope API response.
• Any file-based envelope, or any envelope with multiple signers: the field is delivered through the envelope-sent webhook instead. It isn't present in the create-envelope response, so listening for the webhook is the only way to get it.

{
  "envelope_signing_embed": "https://app.signable.co.uk/sign/..."
}

Set up webhooks in your Signable account:

1. Go to your API settings.
2. Add your webhook endpoint URL.
3. Enable the envelope-sent webhook. This is what delivers the envelope_signing_embed URL for file-based and multi-party envelopes — without it, you have no way to retrieve the signing URL for those envelopes.
4. Enable the signed-envelope webhook (for multi-party envelopes). This tells your system when signing is complete.

Your endpoint must return a 2xx HTTP status to confirm receipt.

The envelope-sent 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.