Skip to main content

Webhooks - How to use them?

Updated over a week ago

Tomorro’s action(s) that can trigger the automation:

  • A contract has been create

  • A contract has been deleted

  • A contract has been fully signed

  • A contract status has been updated

  • A reminder has been triggered

Create a Tomorro's webhook

Select “Add a webhook”

4 tasks to do here :

  1. Name your webhook

  2. Paste the URL created to receive the event

  3. Select which trigger will activate the automation (can be multiple)

  4. Creat webhook

Nb : webhooks are personnal.

Ex :

The contract creation webhook is only triggered if I am a participant.

The automatic reminder webhook is only triggered if the reminder is intended for me.

Webhook example

Here is an example of a complete webhook (contract creation) so you can handle multiples datas.

{
"eventId": "b21213e3-8a9a-4e04-9bfc-c4e53f123xxx",
"webhookId": "2a76094c-1f2e-48c8-a47f-1add41234xxx",
"createdAt": "2025-03-25T14:55:16.280Z",
"eventType": "contractCreated",
"data": {
"contract": {
"id": "6954ad41-19f3-446f-b0db-fcc661234xxx",
"name": "TestWebhook",
"organizationId": "115e926b-9c61-4172-8609-02212344exxx",
"author": {
"id": "974d2a1c-eb63-4237-877e-37d12341axxx",
"user": {
"id": "fd61234d-a4e1-4103-8d31-59e351d2bxxx",
"username": "paul.lubet@tomorro.com",
"firstname": "Paul",
"lastname": "Lubet"
}
},
"referent": {
"id": "974d2a1c-eb63-4237-877e-37123451axxx",
"user": {
"id": "fd61234d-a4e1-4103-8d31-59e351d2bxxx",
"username": "paul.lubet@tomorro.com",
"firstname": "Paul",
"lastname": "Lubet"
}
},
"referentId": "974d2a1c-eb63-4237-877e-37123451axxx",
"supervisorId": null,
"externalCompany": {
"id": "01611234-7cdf-4785-966e-ee06b74ccxxx",
"name": "My external company"
},
"priorNoticeDuration": "undefined",
"priorNoticeValue": null,
"renewal": "no",
"signatureDate": null,
"status": "draft",
"createdAt": "2025-03-25T14:55:14.690Z",
"updatedAt": "2025-03-25T14:55:14.000Z",
"documentId": null,
"typeId": null,
"templateId": null,
"contractAttributes": [
{
"attributeDefinition": {
"name": "durationType"
},
"value": "PERMANENT"
},
{
"attributeDefinition": {
"name": "endAt"
},
"value": null
},
{
"attributeDefinition": {
"name": "externalPartyName"
},
"value": "My external company"
},
{
"attributeDefinition": {
"name": "initialDuration"
},
"value": null
},
{
"attributeDefinition": {
"name": "internalPartyName"
},
"value": "Paul Lubet"
},
{
"attributeDefinition": {
"name": "language"
},
"value": "fr"
},
{
"attributeDefinition": {
"name": "nextRenewalDate"
},
"value": null
},
{
"attributeDefinition": {
"name": "priorNotice"
},
"value": null
},
{
"attributeDefinition": {
"name": "renewalDuration"
},
"value": null
},
{
"attributeDefinition": {
"name": "renewalType"
},
"value": "no"
},
{
"attributeDefinition": {
"name": "signatureDate"
},
"value": null
},
{
"attributeDefinition": {
"name": "startAt"
},
"value": null
}
],
"attributes": {
"durationType": {
"value": "PERMANENT",
"name": "durationType",
"attributeDefinitionId": "durationType"
},
"endAt": {
"value": null,
"name": "endAt",
"attributeDefinitionId": "endAt"
},
"externalPartyName": {
"value": "My external company",
"name": "externalPartyName",
"attributeDefinitionId": "externalPartyName"
},
"initialDuration": {
"value": null,
"name": "initialDuration",
"attributeDefinitionId": "initialDuration"
},
"internalPartyName": {
"value": "Paul Lubet",
"name": "internalPartyName",
"attributeDefinitionId": "internalPartyName"
},
"language": {
"value": "fr",
"name": "language",
"attributeDefinitionId": "language"
},
"nextRenewalDate": {
"value": null,
"name": "nextRenewalDate",
"attributeDefinitionId": "nextRenewalDate"
},
"priorNotice": {
"value": null,
"name": "priorNotice",
"attributeDefinitionId": "priorNotice"
},
"renewalDuration": {
"value": null,
"name": "renewalDuration",
"attributeDefinitionId": "renewalDuration"
},
"renewalType": {
"value": "no",
"name": "renewalType",
"attributeDefinitionId": "renewalType"
},
"signatureDate": {
"value": null,
"name": "signatureDate",
"attributeDefinitionId": "signatureDate"
},
"startAt": {
"value": null,
"name": "startAt",
"attributeDefinitionId": "startAt"
}
}
}
}
}

Did this answer your question?