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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Add contacts to list

> Add existing Brevo contacts to a contact list.

`addContactsToList` adds contacts identified by email and reports provider
successes and failures separately.

## Example

```ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { addContactsToList } from "automate.ax/brevo"

export default automation("Add launch contacts", () => {
  onHttpRequest({ scope: "automation" })

  addContactsToList({
    list: "2026 Launch",
    emails: ["ada@example.com", "grace@example.com"],
  })
})
```

`list: string | number` and a non-empty `emails` array are required. Contacts
must already exist; this action does not upsert them. `account` selects the
Brevo binding.

Returns `{ success: string[]; failure: string[] }`. Partial failure is a normal
provider result rather than an action error, so inspect `failure` before
assuming every membership changed.