Relation Create

Overview

This webhook response is triggered when an relation between objects is created.

For example, in a business management system, a company may want to establish an association between a custom object record and a contact. In this case:

• The second object (contact) would represent a person associated with the custom object record.
• The first object (custom object) could represent an entity such as a project or a transaction.
• The system allows for dynamic relationships between entities, facilitating better data management.

This event is emitted for relations created through custom object associations and through company-to-contact associations: both the built-in primary company link and user-defined labels (for example, "Employee"). See Company-to-contact associations.

Schema

The webhook response follows the JSON schema below:

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "firstObjectKey": {
      "type": "string"
    },
    "firstRecordId": {
      "type": "string"
    },
    "secondObjectKey": {
      "type": "string"
    },
    "secondRecordId": {
      "type": "string"
    },
    "associationId": {
      "type": "string"
    },
    "locationId": {
      "type": "string"
    }
  }
}

Field Descriptions

id

• Type: string
• Unique identifier for the created association.

firstObjectKey

• Type: string
• Key representing the first object in the association.

firstRecordId

• Type: string
• Identifier of the first object’s specific record.

secondObjectKey

• Type: string
• Key representing the second object in the association.

secondRecordId

• Type: string
• Identifier of the second object’s specific record.

associationId

• Type: string
• Unique identifier for the association that was created.

locationId

• Type: string
• Identifies the location associated with the created association.

Example Response

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

Company-to-contact associations

RelationCreate is delivered for company-to-contact relations:

• Primary company — the built-in association, delivered with associationId BUSINESSES_CONTACTS_ASSOCIATION. Primary company links created through the associations relations API (for example, on the record page) trigger this event; changes made only to the contact's businessId field (for example, bulk Manage companies) do not.
• User-defined labels (for example, "Employee") — delivered with the label's own associationId.

In both cases firstObjectKey / secondObjectKey are business and contact.

Relations written by platform data migrations or backfills (for example, when existing primary company links are copied into relations) are not delivered.

Additional Notes

• The firstObjectKey and secondObjectKey define the relationship between the created entities.