contact.updated
A contact changed. It lists which fields, never their values.
Agoo sends this as a signed POST to every enabled endpoint subscribed to contact.updated (or *).
Verify the signature, return any 2xx within 15 seconds, and de-duplicate on webhook-id.
webhook-id*stringThe event's ID. It is the same on every attempt and redelivery, so use it to de-duplicate.
^evt_[0-7][0-9a-hjkmnp-tv-z]{25}$"evt_01m4ww0ezgf2bryg9gxb2gbewx"webhook-timestamp*stringWhen this attempt was signed, in Unix seconds. Reject the request if it is more than 5 minutes from your clock.
^[0-9]+$webhook-signature*stringOne or more space-separated signatures, each v1,<base64>: the base64 HMAC-SHA256 of
{webhook-id}.{webhook-timestamp}.{raw body}, keyed with the base64-decoded part of your whsec_ secret.
During a secret rotation there are two. Accept the request if any one matches.
application/json- body
An event about a contact, company or import. It carries an id and what a key could read anyway: never a protected field.
id*EventIdThe event's ID. Webhook deliveries send it as webhook-id.
^evt_[0-7][0-9a-hjkmnp-tv-z]{25}$"evt_01m4ww0ezgf2bryg9gxb2gbewx"created_at*stringWhen the event happened.
date-timeorganisation_id*OrganisationIdAn organisation ID (TypeID with the org prefix).
^org_[0-7][0-9a-hjkmnp-tv-z]{25}$"org_01kjpsrza0etzb0a4vf72x8ang"livemode*booleanfalse for events in test mode.
type*string"contact.created""contact.updated""contact.merged""contact.unmerged""contact.erased""contact.consent_granted""contact.consent_withdrawn""company.created""company.updated""import.completed"data*Any 2xx acknowledges it.
Example Requests
/contact.updatedcontact.created Webhook
A contact was made: by a person, the API, or a visit, booking or message. Agoo sends this as a signed `POST` to every enabled endpoint subscribed to `contact.created` (or `*`). Verify the signature, return any `2xx` within 15 seconds, and de-duplicate on `webhook-id`.
contact.merged Webhook
Contacts were merged, by a person, or by an organisation's own rule for exact duplicates. Agoo sends this as a signed `POST` to every enabled endpoint subscribed to `contact.merged` (or `*`). Verify the signature, return any `2xx` within 15 seconds, and de-duplicate on `webhook-id`.