Association Create | Webhook Events

The AssociationCreate event fires when a new association type is defined between two object types in an account. An association defines the structural relationship rule — for example, linking “Buyer” custom objects to “Property” custom objects. Associations support contact-to-contact, contact-to-custom object, and custom-to-custom object configurations. Use this event to replicate your data model to external systems or automatically configure dependent tooling when new relationship types are introduced.

Payload

Field	Type	Description
`id`	`string`	Unique identifier for the association definition
`key`	`string`	Unique key for this association type (e.g., `"custom_objects.buyer_to_property"`)
`firstObjectKey`	`string`	Object type key for the first side of the association
`secondObjectKey`	`string`	Object type key for the second side of the association
`firstObjectLabel`	`string`	Human-readable label for the first object’s role in the relationship
`secondObjectLabel`	`string`	Human-readable label for the second object’s role in the relationship
`associationType`	`string`	Whether the association is `"USER_DEFINED"` or system-defined
`locationId`	`string`	Account ID where the association type was created

Example payload

{
  "id": "67ade73d1119d2ac7ad0c475",
  "key": "custom_objects.buyer_to_property",
  "firstObjectKey": "custom_objects.buyer",
  "secondObjectKey": "custom_objects.property",
  "firstObjectLabel": "Interested Buyer",
  "secondObjectLabel": "Property",
  "associationType": "USER_DEFINED",
  "locationId": "eHy2cOSZxMQzQ6Yyvl8P"
}

Association Update — fires when an association definition is modified
Association Delete — fires when an association definition is removed
Associations API — manage association definitions and relations

​Payload

​Example payload

​Related

Payload

Example payload

Related