Skip to main content
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

FieldTypeDescription
idstringUnique identifier for this relation instance
firstObjectKeystringObject type key for the first record in the relationship (e.g., "custom_objects.mad")
secondObjectKeystringObject type key for the second record in the relationship (e.g., "contact")
firstRecordIdstringID of the specific record on the first side of the link
secondRecordIdstringID of the specific record on the second side of the link
associationIdstringID of the association definition that governs this relation
locationIdstringSub-account ID where this relation exists

​
Example payload

{
  "id": "67ae0d741119d218c9d0c477",
  "firstObjectKey": "custom_objects.mad",
  "firstRecordId": "67a349a79b28947ec1f65bb5",
  "secondObjectKey": "contact",
  "secondRecordId": "emqfhnG3g9D9chy9inTz",
  "associationId": "669e5795add2094075906c65",
  "locationId": "eHy2cOSZxMQzQ6Yyvl8P"
}
Last modified on March 4, 2026