How webhooks works
Set up your webhooks in less than 1 minute.
Introduction
The webhook is the simplest and most efficient way for your system to know when an event occurs at ZapSign (ie. a document has been signed). This is because by registering a webhook, your system will be proactively warned by ZapSign as soon as an event occurs (in practice, ZapSign sends a POST request to your server).
Thus, the great advantage of the webhook is that instead of your system making several requests per day, hour and minute to ZapSign (a practice known as polling), checking if there was any update in the documents, ZapSign takes care of this work and notifies you, saving resources on both sides.
Your application must return status 200 when receiving a webhook, otherwise ZapSign will retry the POST, generating duplicates and/or unnecessary requests.
Do I need to have an API Plan to use webhooks? No, webhooks are freely available to all users. But API users are strongly recommended to use webhooks instead of polling.
Setting up a webhook
Once inside your account, click on Settings > Integrations in the sidebar.
Inside, click on toggle, in webhook section, as indicated below.
![](https://docs.zapsign.com.br/~gitbook/image?url=https%3A%2F%2F1401277393-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-M4noMoX5ZGb2-RhWjjf-1703796690%252Fuploads%252F1ATLGHCyz9bNhy33e4mx%252F0d4ded78-72c7-4766-95cd-53fc77e4841b.png%3Falt%3Dmedia%26token%3D4697bbce-be5a-4042-a2bb-ef2f8dcee548&width=768&dpr=4&quality=100&sign=e26c6a4c&sv=1)
Now, with the Webhooks enabled, just enter the URL of the endpoints where you want to receive the webhooks.
Tip: for testing, you can start by registering a webhook from https://webhook.site/ to understand how the requests that will arrive in your application work.
Below, I registered, for example, one webhook for testing (from webhook.site).
![](https://docs.zapsign.com.br/~gitbook/image?url=https%3A%2F%2F1401277393-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-M4noMoX5ZGb2-RhWjjf-1703796690%252Fuploads%252FO3SxLBWnYn0OliWojNAK%252F3dd1ea3f-cfcb-43d1-9e43-bae35753d17d.png%3Falt%3Dmedia%26token%3D0aa395a4-8f00-46e2-bacf-73fea7783e2f&width=768&dpr=4&quality=100&sign=da6e608d&sv=1)
Everything going well, you will start receiving webhooks on all registered endpoints!
See how you would receive webhooks on webhook.site for example:
Last updated