Migrating from Webhooks V2 to V3
Different philosophy
Webhooks on V2 are set up per SR whereas in V3 there is a limited number of Webhooks per organization (5 in the app, 5 in the API). It is based on global events and related to what is happening in all the organization.
⇒ The implementation is different to meet best practices and market standards
Is it possible to create custom header X-Custom-Header from V2 into V3?
X-Custom-Header from V2 into V3?- On v2, it is mainly used to add
client_idand the API key or bearer token - We don't want to leave this usage of putting all the info in the header but there are other solutions:
- For the authentification, it is not secured to put these info in the header. And with the hashmac, we answer this need
- For the
client_id, there is theexternal_idwhich allows to put the client recognition
Are the events the same?
We don't have strictly the same events to listen:
| v2 | v3 | Use case |
|---|---|---|
| member.started | signer.notified approver.notified | - A specific Signer can now sign - An approver gets the information that the signature request needs its approval |
| member.finished | signer.done approver.approved | - A specific Signer has completed its Signature Request - An approver approved the signature request |
| reminder.executed | signature_request.reminder_executed | An manual or automatic reminder has been sent |
| procedure.started | signature_request.activated | A Signature Request has been activated |
| procedure.finished | signature_request.done | A Signature Request has been completed, all the Signers have signed |
| procedure.expired | signature_request.expired | A Signature Request has expired |
| procedure.created | N/A | No use detected in v3 as we now have the feature to follow the overall consumption |
| procedure.refused | N/A approver.rejected | No possibility to reject a SR in V3. |
| procedure.deleted | N/A | Not available in V3 |
| procedure.error | N/A | Not available in V3 |
| comment.created | N/A | This feature doesn't exist on the V3 |
| server_stamp.finished | electronic_seal.done | Electronic seal successfully created |
| server_stamp.error | electronic_seal.error | Electronic seal could not be created because of an error |
Updated 17 days ago