Add Members to Address List

Add one or more email addresses to an existing address list (supports batch addition). Upsert semantics: a member that already exists in the list is updated (name/vars) instead of being rejected. Batch tolerance: entries with invalid email format or over-long values are skipped and reported in invalidAddressList/reasonList; the request itself still succeeds. Either address or mailListName must be provided (address takes precedence when both are present; a non-unique mailListName inserts into every matching list).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Form Data
string
length between 1 and 64

Address of the target address list (to which members are added). Optional if mailListName is provided; must belong to the calling account, otherwise 40517.

string

Alternative to address: locate the target list(s) by list name. Used only when address is blank; must match an existing list of this account (40517 otherwise). If several lists share the name, members are inserted into all of them.

string
required

Email addresses to add (separated by semicolons, supports batch addition). At most 1000 per request (40515); each entry at most 127 characters. Invalid entries are skipped and reported in invalidAddressList/reasonList.

string

Member names separated by semicolons. Count must equal members count (40528); each name at most 127 characters (invalid ones only flagged in reasonList).

string

Substitution variables corresponding to members, formatted as {"money":"1000"}; separated by semicolons (a variable value containing semicolons is tolerated by brace matching). Count must equal members count (40521); each JSON object at most 2048 characters and must be valid JSON, otherwise the member is skipped with a reason (not a request-level failure). The keys "name" and "recipient" are dropped from vars.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json