Auth
- Auth method
none- Signature detail
- Mailchimp webhooks do not include a built-in signature header. Authentication relies on a secret token embedded in the webhook callback URL.
Delivery
- Guarantees
- at-least-once
- Backoff
- Mailchimp retries failed webhook deliveries a limited number of times.
Payload schema (field names + types only)
type string required
Event type identifier, e.g. 'unsubscribe'.
fired_at string required
Datetime string (Y-m-d H:i:s) when the event was fired.
data object required
Event-specific data payload.
id string
Mailchimp unique member ID (hashed email).
list_id string required
Audience/list ID.
email string required
Subscriber's email address.
email_type string
Email format preference (html or text).
ip_opt string | null
IP address recorded at opt-in/out.
ip_signup string | null
IP address recorded at signup.
web_id integer
Numeric web ID for this subscriber.
merges object
Merge field values for the subscriber (e.g. FNAME, LNAME, plus custom fields).
action string (enum) required
Whether the user unsubscribed or was deleted.
reason string
Reason for the unsubscribe action.
campaign_id string | null
Campaign ID that prompted the unsubscribe, if applicable.
Notes: Mailchimp webhooks deliver data as application/x-www-form-urlencoded POST or JSON depending on configuration. fired_at uses 'Y-m-d H:i:s' format, not ISO 8601.
Vendor docs