Matchai Docs

An approval request was answeredComing soon

Event approval.resolved. A final action your app asked for was approved (and performed), declined, or expired. data.object.result holds the outcome.

Coming soon. This is documented ahead of launch so you can plan your integration; it is not available yet.

Coming soon. Event approval.resolved. A final action your app asked for was approved (and performed), declined, or expired. data.object.result holds the outcome.

Verify Matchai-Signature before trusting the body, and answer with any 2xx within 10 seconds.

Scopes to receive it: none — sent to the app that asked for the approval

Pricing: Included with the connection.

Header Parameters

Matchai-Signature*string

t=<unix seconds>,v1=<hex HMAC-SHA256>. During a secret rotation it carries two v1 values.

Matchai-Event-Id*string

Same as the body’s id. Use it to ignore duplicates.

Matchai-Delivery-Attempt*integer

Attempt number, from 1.

Range1 <= value

Request Body

application/json
  1. body

The body of every webhook delivery, and of GET /events.

id*string

Event id. Deliveries can repeat: use it to ignore duplicates.

Length1 <= length <= 64
type*string

New event types may be added. Ignore types you do not know.

Value in"lead.created""contact.created""contact.updated""contact.converted""contact.deleted""conversation.created""message.received""message.sent""appointment.requested""appointment.booked""appointment.rescheduled""appointment.cancelled""listing.created""listing.updated""listing.published""listing.unpublished""listing.archived""listing.deleted""listing.saved""listing.generation.completed""document.created""drop_link.upload_received""invitation.accepted""notification.created""approval.resolved""webhook.test"
created_at*string

When it happened.

Formatdate-time
api_version*string
test_mode*boolean

Sent for a test connection or by POST /webhook-subscriptions/{id}/test.

account*
data*

Response Body

Received. Any 2xx status works. Anything else, or no answer within 10 seconds, is retried.

Example Requests
POST/approval.resolved
Request Body
application/json
{  "id": "string",  "type": "lead.created",  "created_at": "2019-08-24T14:15:22Z",  "api_version": "v1",  "test_mode": true,  "account": {    "user_id": "string"  },  "data": {    "object": {}  }}
Header Parameters
{  "Matchai-Signature": "t=1760627565,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd",  "Matchai-Event-Id": "string",  "Matchai-Delivery-Attempt": 1}