---
title: "Add Contacts to List"
method: POST
path: "/lists/{name}/contacts"
tags: ["Lists"]
---

# Add Contacts to List

`POST /lists/{name}/contacts`

Add existing Contacts to specified list. Required Access Level: ModifyContacts

## Path parameters

- `name` string, string, required — string

## Request body

- EmailsPayload — Provide either rule or a list of emails, not both.
  - `Rule` string, string — SQL-like rule. Sending 'All' as a value loads all resources of the given type. Help for building a segment rule can be found here: https://help.elasticemail.com/en/articles/5162182-segment-rules
  - `Emails` string[] — Comma delimited list of contact emails

## Response `200`

OK

- ContactsList — List of Lists, with detailed data about its contents.
  - `ListName` string, string — Name of your list.
  - `PublicListID` string, guid, nullable — ID code of list. Please note that this is different from the listid field.
  - `DateAdded` string, date-time — Date of creation in YYYY-MM-DDThh:ii:ss format
  - `AllowUnsubscribe` boolean — True: Allow unsubscribing from this list. Otherwise, false

---

[API](https://skmtc.net/elasticemail/apis/megamail-api.md) · [All operations](https://skmtc.net/elasticemail/apis/megamail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elasticemail/megamail-api/versions/1a0ebb83f676/schema)