Brand Webhooks
Overview
Brand webhooks allow you to receive real-time notifications when specific events occur for your brand. Currently supported topics include ‘Deals’, ‘Showings’, ‘Contacts’, and ‘Activities’.
Resource Group ¶
Create Brand Webhook ¶
Create Brand WebhookPOST/brands/:id/webhooks
Creates a new webhook for a brand that will receive notifications for the specified topic.
Example URI
POST /brands/:id/webhooks
URI Parameters
- id
string(required) Example: 737bf429-a256-4193-9d9c-9d85dcca2ee2
Request
Body
{
"topic": "Showings",
"url": "https://localhost:3000"
}Response
200Body
{
"code": "OK",
"data": {
"id": "80832750-7624-4682-9f99-b7bd742f48c9",
"created_at": 1787791941.199067,
"updated_at": 1787791941.199067,
"deleted_at": null,
"brand": "737bf429-a256-4193-9d9c-9d85dcca2ee2",
"topic": "Showings",
"url": "https://localhost:3000",
"key": "d2276e5ea62caa15259a4bb7c547e5d2aa2c1cbbd7eb3d4266412fd1d7d7a7b9",
"tags": null,
"type": "brand_webhook"
}
}Get All Brand Webhooks ¶
Get All Brand WebhooksGET/brands/:id/webhooks
Gets a list of all webhooks for a brand. Does not return deleted records. To fetch a list of brand webhooks for a specific topic, use the topic query parameter.
Example URI
GET /brands/:id/webhooks
URI Parameters
- id
string(required) Example: 737bf429-a256-4193-9d9c-9d85dcca2ee2
Response
200Body
{
"code": "OK",
"data": [
{
"id": "80832750-7624-4682-9f99-b7bd742f48c9",
"created_at": 1787791941.199067,
"updated_at": 1787791941.199067,
"deleted_at": null,
"brand": "737bf429-a256-4193-9d9c-9d85dcca2ee2",
"topic": "Showings",
"url": "https://localhost:3000",
"key": "d2276e5ea62caa15259a4bb7c547e5d2aa2c1cbbd7eb3d4266412fd1d7d7a7b9",
"tags": null,
"type": "brand_webhook"
}
],
"info": {
"count": 1,
"total": 0
}
}Delete Brand Webhook ¶
Delete Brand WebhookDELETE/brands/:id/webhooks/:wid
Deletes a specific webhook for a brand.
Example URI
DELETE /brands/:id/webhooks/:wid
URI Parameters
- id
string(required) Example: 737bf429-a256-4193-9d9c-9d85dcca2ee2- wid
string(required) Example: 80832750-7624-4682-9f99-b7bd742f48c9
Response
204Body
**Deprecation notice: the 'Activities' topic is due for deprecation and must not be used.**
Webhooks on the 'Activities' topic are called when an activity is recorded on a contact's timeline. The `event` field is the activity's action, such as `ContactViewedListing` or `ContactLeadCaptured`. Depending on the action, the activity carries a `listing`, `lead`, or `search` key in the same format the timeline endpoints accept them in:
{
"topic": "Activities",
"event": "ContactViewedListing",
"timestamp": 1786515688070,
"payload": {
"activity": {
"id": "...",
"action": "ContactViewedListing",
"created_at": 1786515688,
"contact": "...",
"listing": {
"id": "...",
"mls": "...",
"mls_number": "...",
"status": "Active",
"price": 500000,
"address": "123 Main St, Dallas, TX 75201"
}
}
}
}