MAmailchimp
lists

Get merge field

Get information about a specific merge field.

get/3.0/lists/{list_id}/merge-fields/{merge_id}

Request

Path parameters

list_idstring required

The unique ID for the list.

merge_idstring required

The id for the merge field.

Query parameters

exclude_fieldsstring[]

A comma-separated list of fields to exclude. Reference parameters of sub-objects with dot notation.

fieldsstring[]

A comma-separated list of fields to return. Reference parameters of sub-objects with dot notation.

Response

default_valuestring

The default value for the merge field if null.

display_orderinteger

The order that the merge field displays on the list signup form.

help_textstring

Extra text to help the subscriber fill out the form.

list_idstring

The ID that identifies this merge field's audience'.

merge_field_limitinteger

The maximum number of merge fields this audience can hold. The limit is determined by the account's plan. Returned on POST responses only. Subtract total_items from this value to derive the remaining capacity.

merge_idinteger

An unchanging id for the merge field.

namestring

The name of the merge field (audience field).

publicboolean

Whether the merge field is displayed on the signup form.

requiredboolean

The boolean value if the merge field is required.

tagstring

The merge tag used for Mailchimp campaigns and adding contact information.

total_itemsinteger

The total number of merge fields on the audience after this field was created. Returned on POST responses only.

type'text' | 'number' | 'address' | 'phone' | 'date' | 'url' | 'imageurl' | 'radio' | 'dropdown' | 'birthday' | 'zip'

The type for the merge field.

Example response

{
  "merge_field_limit": 30,
  "options": {
    "choices": [
      "First Choice",
      "Second Choice",
      "Third Choice"
    ]
  },
  "total_items": 28
}

Changes

No recorded changes to this operation across all 1 revision of this API.