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

# Add Contacts to a List

> Add contacts to a list, which starts the list's automations for them

# Add Contacts to a List

Adds up to 100 existing contacts to a list. A contact already on the list stays as it is.

Adding a contact starts the automations that follow this list (Automations page, trigger **Added to a list**) for that contact. Each contact goes through an automation once, so calling this again for the same contact starts nothing twice. This is how another system starts a Gomry flow: create or find the contact, then add it to the list the automation follows.

**Required scopes:** `lists:read` and `contacts:write` (adding writes the contact)

## Path Parameters

**listId** `string` *required*

## Body

**contact\_ids** `string[]` *required*

Contact ids, from 1 to 100. Ids that are not contacts of your organization are returned in `invalid_contact_ids` and skipped.

## Response

**list\_id** `string`

**contacts\_on\_list** `integer`

How many of the given contacts are on the list after the call.

**invalid\_contact\_ids** `string[]`

Ids that were skipped.

```json theme={null}
{
  "list_id": "lst_8f2c",
  "contacts_on_list": 2,
  "invalid_contact_ids": []
}
```

## Errors

* `400` the body is not `{ "contact_ids": [...] }` with 1 to 100 ids
* `404` the list is not one of your organization's
* `422` none of the ids are contacts of your organization


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.