Relation Create | Webhook Events

The RelationCreate event fires whenever two specific records are linked together via an association. While an association defines the type of relationship between two object types, a relation is the concrete instance — the actual link between two individual records. Use this event to replicate relationship graphs in external systems, trigger cross-object workflows, or build real-time graph visualizations.

Payload

Field	Type	Description
`id`	`string`	Unique identifier for this relation instance
`firstObjectKey`	`string`	Object type key for the first record in the relationship (e.g., `"custom_objects.mad"`)
`secondObjectKey`	`string`	Object type key for the second record in the relationship (e.g., `"contact"`)
`firstRecordId`	`string`	ID of the specific record on the first side of the link
`secondRecordId`	`string`	ID of the specific record on the second side of the link
`associationId`	`string`	ID of the association definition that governs this relation
`locationId`	`string`	Account ID where this relation exists

Example payload

{
  "id": "67ae0d741119d218c9d0c477",
  "firstObjectKey": "custom_objects.mad",
  "firstRecordId": "67a349a79b28947ec1f65bb5",
  "secondObjectKey": "contact",
  "secondRecordId": "emqfhnG3g9D9chy9inTz",
  "associationId": "669e5795add2094075906c65",
  "locationId": "eHy2cOSZxMQzQ6Yyvl8P"
}

Relation Delete — fires when a record-level link is removed
Association Create — fires when the association type definition is created
Associations API — manage association definitions and relations

​Payload

​Example payload

​Related

Payload

Example payload

Related