> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.meetgail.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.meetgail.com/_mcp/server.

# Add Contact to Contact List

> Adds one or more existing contacts to an existing Gail contact list.

The Add Contact to Contact List node places existing contacts into an existing list. Use
it to enroll people into a curated group, for example moving a lead into a "Qualified
Leads" list once they clear a scoring step.

## When to use it

* A contact just qualified for a segment and you want them in the matching list.
* You created a contact earlier in the run and now want to add them to a list.
* You have a batch of contact IDs and want them all in the same list.

## Inputs

| Field        | What it's for                                                                                                                                                              | Example                                        |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| Contact list | The list to add contacts to, given by its ID. Often the ID returned by an earlier [Create Contact List](/platform/workflows/node-reference/gail/create-contact-list) step. | `019d9c5e-f912-7139-89aa-da1e937ff45d`         |
| Contacts     | One or more contact IDs to add, between 1 and 2,500.                                                                                                                       | The IDs of contacts created earlier in the run |

The Contacts field can be a fixed set of IDs, a mix of fixed IDs and
[expressions](/platform/workflows/core-concepts/expressions/using-expressions-in-nodes), or a single
expression that resolves to a whole list when the count is not known until the run.

## Outputs

| Field   | What you get back                                                                  |
| ------- | ---------------------------------------------------------------------------------- |
| Outcome | Whether the request to add the contacts was accepted.                              |
| Details | The list ID and the contact IDs that were submitted, for reference in later steps. |

## Example

A workflow creates a "High-Value Renewals" list and, as it processes each qualifying
policyholder, uses Add Contact to Contact List to add them to it. The list ID comes from
the earlier [Create Contact List](/platform/workflows/node-reference/gail/create-contact-list)
step, and each contact ID comes from the [Add Contact](/platform/workflows/node-reference/gail/add-contact)
step that created them.

![The Add Contact to Contact List node configuration panel, showing the contact list and contact IDs.](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/gail.docs.buildwithfern.com/4d8ea8734e5cc01181f99fd3e1e7a77b8d32a1c26955fea9122a95a74efb21ef/docs/pages/platform/workflows/assets/gail-add-contact-to-contact-list.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260823%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260823T233056Z&X-Amz-Expires=604800&X-Amz-Signature=1ce8a248e686e206ea254182a56b2416c84e679cd901b39b358194db29185ad0&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

Adding contacts to a list is accepted for processing rather than finished the instant
the node succeeds. If a later step depends on the contacts already being in the list,
do not assume they are there immediately after this node runs.

## Related nodes

#### [Create Contact List](/platform/workflows/node-reference/gail/create-contact-list)

Create the list before adding contacts to it.

#### [Add Contact](/platform/workflows/node-reference/gail/add-contact)

Create a contact whose ID you can add to the list.

#### [Add Contact to Campaign](/platform/workflows/node-reference/gail/add-contact-to-campaign)

Enroll a contact into a campaign instead of, or in addition to, a list.