> ## 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.

# Relation Create | Webhook Events

> Fires when a new relation (record-level link) is established between two object records.

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

| Field             | Type     | Description                                                                             |
| ----------------- | -------- | --------------------------------------------------------------------------------------- |
| `id`              | `string` | Unique identifier for this relation instance                                            |
| `firstObjectKey`  | `string` | Object type key for the first record in the relationship (e.g., `"custom_objects.mad"`) |
| `secondObjectKey` | `string` | Object type key for the second record in the relationship (e.g., `"contact"`)           |
| `firstRecordId`   | `string` | ID of the specific record on the first side of the link                                 |
| `secondRecordId`  | `string` | ID of the specific record on the second side of the link                                |
| `associationId`   | `string` | ID of the association definition that governs this relation                             |
| `locationId`      | `string` | Account ID where this relation exists                                                   |

## Example payload

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

## Related

* [Relation Delete](/api-reference/webhooks/relation-delete) — fires when a record-level link is removed
* [Association Create](/api-reference/webhooks/association-create) — fires when the association type definition is created
* [Associations API](/api-reference/associations/overview) — manage association definitions and relations