> ## Documentation Index
> Fetch the complete documentation index at: https://sendforsign.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks concept

> How Sendforsign webhooks work: get real-time notifications when contracts are viewed, approved or signed.

Webhooks can be created via API calls by using the API references from this section.
Please bear in mind that webhooks are separated by Client Keys, so if you create multiple Client Keys for your platform,
be sure to follow this rule.

When you listen for the webhooks, you will receive them with the `Content-Type: application/vnd.api+json` header.

Webhooks have 6 events to listen for your purposes:

* `Contract.created`: fires when a contract is created.
* `Contract.sent`: fires for every recipient to whom a contract was sent.
* `Contract.seen`: fires every time a recipient opens a contract.
* `Contract.approved`: fires every time a recipient approves a contract.
* `Contract.signed`: fires every time a recipient signs a contract.
* `Contract.fully_signed`: fires once when all the recipients have signed a contract.

Below you will find the examples of webhooks.

### "contract.created"

```bash json theme={null}
{
  "clientKey": "658599d9-bbbe-44ea-984e-0e5a766c2272",
  "contractKey": "433e835c-0630-418c-8cd6-af223bb079d5",
  "createTime": "2024-12-13T15:47:53.000Z",
  "status": "contract.created"
}
```

### "contract.sent"

```bash json theme={null}
{
  "clientKey": "658599d9-bbbe-44ea-984e-0e5a766c2272",
  "contractKey": "433e835c-0630-418c-8cd6-af223bb079d5",
  "createTime": "2024-12-13T16:02:27.000Z",
  "status": "contract.sent",
  "email": "ilia@sfs.com",
  "fullname": "Ilia Bovk",
  "contractName": "Sales Contract",
  "recipientKey": "b113a5ea-115b-465c-a10f-baa361378e10"
}
```

### "contract.seen"

```bash json theme={null}
{
  "clientKey": "658599d9-bbbe-44ea-984e-0e5a766c2272",
  "contractKey": "433e835c-0630-418c-8cd6-af223bb079d5",
  "createTime": "2024-12-13T16:03:39.000Z",
  "status": "contract.seen",
  "email": "ilia@sfs.com",
  "fullname": "Ilia Bovk",
  "contractName": "Sales Contract",
  "recipientKey": "b113a5ea-115b-465c-a10f-baa361378e10"
}
```

### "contract.approved"

```bash json theme={null}
{
  "clientKey": "658599d9-bbbe-44ea-984e-0e5a766c2272",
  "contractKey": "433e835c-0630-418c-8cd6-af223bb079d5",
  "createTime": "2024-12-13T16:05:06.000Z",
  "status": "contract.approved",
  "email": "ilia@sfs.com",
  "fullname": "Ilia Bovk",
  "contractName": "Sales Contract",
  "recipientKey": "b113a5ea-115b-465c-a10f-baa361378e10"
}
```

### "contract.signed"

```bash json theme={null}
{
  "clientKey": "658599d9-bbbe-44ea-984e-0e5a766c2272",
  "contractKey": "433e835c-0630-418c-8cd6-af223bb079d5",
  "createTime": "2024-12-13T16:06:56.000Z",
  "status": "contract.signed",
  "email": "ilia@sendforsign.com",
  "fullname": "Ilia Bovk",
  "contractName": "Sales Contract",
  "recipientKey": "b113a5ea-115b-465c-a10f-baa361378e10"
}
```

### "contract.fully\_signed"

```bash json theme={null}
{
  "clientKey": "658599d9-bbbe-44ea-984e-0e5a766c2272",
  "contractKey": "433e835c-0630-418c-8cd6-af223bb079d5",
  "createTime": "2024-12-13T16:06:56.000Z",
  "status": "contract.fully_signed",
  "contractName": "Sales Contract"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.