# POST /lists/{id}/contacts

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

Add contacts to a static list.

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

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

**Success status:** `201`

**Rate limit:** 100/min per key, counted against the organization's WRITE ceiling (400/min).

**Path parameters**

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

**Body parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `contactIds` | uuid[] | yes | Contact UUIDs, every one from this workspace. One that is not, or does not exist, refuses the whole request (403 `workspaces.crossWorkspaceReference`) rather than being skipped. Between 1 and 500 per request. |

**Endpoint-specific errors** (beyond the shared error set):

- `400`: `lists.cannotModifyDynamicList`: the list is dynamic, so its members are whoever its rules match. Change the rules instead.
- `403`: `workspaces.crossWorkspaceReference`: a contact id that is not in this workspace, or does not exist. Both answer the same, so the refusal confirms nothing about another workspace.

> Idempotent: a contact already on the list is left alone. Each newly added contact enters every ACTIVE sequence whose `LIST_ADDED` trigger names this list, so this route is where a list-driven automation starts. A dynamic list is refused (400 `lists.cannotModifyDynamicList`); change its rules instead. The response is `{ id, name, type, contactCount }`: the list and its member count after the write.


---

Rate limits: 100/min per key, counted against the organization's WRITE ceiling (400/min). Both windows are one minute.
