# POST /contacts/{id}/events

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

Track a custom event for a contact.

```http
POST https://api.sendheron.com/api/v1/contacts/{id}/events
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `contacts:write`

**Success status:** `201`

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | uuid | yes | Contact UUID. |

**Body parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `name` | string | yes | Event name. |
| `properties` | object | no | Event-specific metadata, stored as JSONB. |


---

Rate limits (global, all applied at once): 60 per minute, 150 per 5 minutes, 300 per hour, 2000 per day.