> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breakcold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Relation Webhooks

> Payloads for relation added and removed events.

Relation webhooks fire when a relationship between two records is added or removed.

All relation webhooks use the same webhook envelope documented in [Webhooks](/api/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.

```json theme={null}
{
  "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.

```json theme={null}
{
  "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"
  }
}
```