# Send an envelope with embedded signing

Create envelopes with embedded signing and retrieve signing page URLs.

## Prerequisites

- Embedded signing enabled on your account
- Signable API credentials
- Webhook endpoint configured (for multi-party envelopes)


## Create an envelope

Send a POST request to create an envelope:


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

Include 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.

## Retrieve the signing URL

How you retrieve the signing URL depends on your envelope type.

Single-party envelopes
For envelopes with one signer, extract the signing URL directly from the API response:


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

Multi-party envelopes
For envelopes with multiple signers, configure the `envelope-sent` webhook. The signing URL is returned in the `envelope_signing_embed` property.

1. On sending an envelope, the `envelope-sent` webhook will trigger, containing the first signer's URL.
2. Each time a signer completes their signature, the webhook payload contains the next signer's URL.


## Configure webhooks

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
4. Enable the `signed-envelope` webhook (for multi-party envelopes)


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

## Webhook payload

The webhook payload includes the signing URL:


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

Extract this value and deliver it through your chosen channel.

## Deliver the signing URL

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.