> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Association Create | Webhook Events

> Fires when a new association type is defined between two object types.

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

```json theme={null}
{
  "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"
}
```

## Related

* [Association Update](/api-reference/webhooks/association-update) — fires when an association definition is modified
* [Association Delete](/api-reference/webhooks/association-delete) — fires when an association definition is removed
* [Associations API](/api-reference/associations/overview) — manage association definitions and relations