Add contacts to a list
add_contactsAdds 1–1,000 contacts to a marketing list, creating it if absent, updating existing names, and rejecting duplicates or invalid addresses without sending email.
Instructions
POST /contacts. Adds 1 to 1,000 contacts to a marketing contact list, creating the list if it does not exist. Existing contacts get their name updated and are added to the list; nobody is duplicated. Invalid, disposable, role/no-reply, suppressed and duplicate addresses are rejected and listed in errors (with their index); the rest are still added. When the plan's contact limit is reached, summary.limit_reached is true. Imports are limited to 120 requests per 15 minutes. Only add people who agreed to receive marketing email. Needs a full-access key. Does not send any email.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"list_name": "<list_name>",
"contacts": "<contacts>"
},
"name": "add_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contacts | Yes | 1 to 1,000 entries. Each is an email address, or { email, first_name?, last_name? }. | |
| list_name | Yes | Name of the contact list. Created if it does not exist. |