The merge tag used in campaigns (e.g., 'FNAME', 'COMPANY'). Must be 1-10 uppercase letters/numbers. If not provided, Mailchimp auto-generates one from the name.
namestring
Required
The display name of the merge field shown to users (e.g., 'First Name', 'Company').
typestring
Required
The field type. Use 'text' for general text, 'number' for numeric values, 'address' for full addresses, 'phone' for phone numbers, 'date' for dates, 'url' for web links, 'imageurl' for image URLs, 'radio' or 'dropdown' for single-choice fields (requires options_choices), 'birthd…
publicboolean
Whether this field is visible on signup forms. Defaults to true.
list_idstring
Required
The unique ID for the audience/list. Get this from the List Audiences endpoint or your Mailchimp dashboard.
requiredboolean
Whether this field is required when importing or adding contacts. Defaults to false.
help_textstring
Help text displayed below the field on signup forms to guide users.
default_valuestring
The default value to use when the field is empty or null.
display_orderinteger
The display order of this field on signup forms. Lower numbers appear first.
options__sizeinteger
For 'text' type fields: the default display width of the text field (in characters).
options__choicesarray
For 'radio' or 'dropdown' type fields: list of choices for users to select from (e.g., ['Option 1', 'Option 2', 'Option 3']).
options__date__formatstring
For 'date' or 'birthday' type fields: the date format (e.g., 'MM/DD/YYYY', 'DD/MM/YYYY').
Observable output
data
Required
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulboolean
Required
Whether or not the action execution was successful or not