Skip to main content
The AssociationCreate event fires when a new association type is defined between two object types in a sub-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

FieldTypeDescription
idstringUnique identifier for the association definition
keystringUnique key for this association type (e.g., "custom_objects.buyer_to_property")
firstObjectKeystringObject type key for the first side of the association
secondObjectKeystringObject type key for the second side of the association
firstObjectLabelstringHuman-readable label for the first object’s role in the relationship
secondObjectLabelstringHuman-readable label for the second object’s role in the relationship
associationTypestringWhether the association is "USER_DEFINED" or system-defined
locationIdstringSub-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"
}
Last modified on March 4, 2026