Relation Webhooks

Relation webhooks fire when a relationship between two records is added or removed. All relation webhooks use the same webhook envelope documented in Webhooks. The data object changes by event type.

Events

Event	Category	When it fires
`relation.added`	CRM	Fired when a relation is added between records.
`relation.removed`	CRM	Fired when a relation is removed between records.

Payload examples

`relation.added`

Fired when a relation is added between records.

{
  "eventId": "evt_abc123",
  "timestamp": "2026-03-19T12:00:00.000Z",
  "workspaceId": "workspace_id",
  "event": "relation.added",
  "data": {
    "sourceRecordId": "record_id",
    "targetRecordId": "related_record_id",
    "fieldDefinitionId": "field_definition_id",
    "fieldSlug": "company"
  }
}

`relation.removed`

Fired when a relation is removed between records.

{
  "eventId": "evt_abc123",
  "timestamp": "2026-03-19T12:00:00.000Z",
  "workspaceId": "workspace_id",
  "event": "relation.removed",
  "data": {
    "sourceRecordId": "record_id",
    "targetRecordId": "related_record_id",
    "fieldDefinitionId": "field_definition_id",
    "fieldSlug": "company"
  }
}

Start here

Webhooks

Core concepts

Events

Payload examples

`relation.added`

`relation.removed`

​Events

​Payload examples

​relation.added

​relation.removed

Events

Payload examples

`relation.added`

`relation.removed`