My Profile
Sign Out
Ask Cody
Knowledge Base
Tickets
Login
Category
  2. Integrations
  3. Mailchimp Integration

Mailchimp Integration Errors and Resolution in BoldDesk

Updated:

This article helps you troubleshoot common Mailchimp integration errors in BoldDesk. These errors typically occur when subscribing or unsubscribing contacts to a Mailchimp mailing list and are usually caused by missing or invalid email addresses, or by attempting to perform mailing list actions on contacts, conversations, or tickets that are blocked, deleted, or marked as spam. Use this guide to understand why an error occurs and the steps required to successfully complete the Mailchimp operation.

Email Identifier Validation Errors

Error message When it displays How to resolve
Invalid email ID The provided email ID is invalid or malformed. Verify the email ID format and value, then retry the request.
Email ID is required. The request is missing the required email ID field during a Mailchimp API operation. Provide the required email ID field in the request payload and retry.

Subscription Eligibility Errors (Subscribe/Unsubscribe Blocked by Record State)

These errors occur when the integration is asked to subscribe or unsubscribe a mailing list entry, but the source object is in a state that is not eligible for the requested operation.

Error message When it displays How to resolve
Mailing list cannot be subscribed to a blocked contact. Subscribe request targets a contact that is blocked. Unblock the contact (if supported by the source system policy) or choose a different eligible contact, then retry.
Mailing list cannot be subscribed to a deleted contact. Subscribe request targets a contact that is deleted. Use an active (not deleted) contact record and retry.
Mailing list cannot be unsubscribed to a blocked contact. Unsubscribe request targets a contact that is blocked. Unblock the contact (if supported) or use an eligible contact record, then retry.
Mailing list cannot be unsubscribed to a deleted contact. Unsubscribe request targets a contact that is deleted. Use an active (not deleted) contact record and retry.
Mailing list cannot be subscribed to a deleted conversation. Subscribe request targets a conversation that is deleted. Use an active (not deleted) conversation and retry.
Mailing list cannot be subscribed to a deleted ticket. Subscribe request targets a ticket that is deleted. Use an active (not deleted) ticket and retry.
Mailing list cannot be subscribed to a spam conversation. Subscribe request targets a conversation marked as spam. Use a non-spam conversation or correct the spam state if that is supported operationally, then retry.
Mailing list cannot be subscribed to a spam ticket. Subscribe request targets a ticket marked as spam. Use a non-spam ticket or correct the spam state if supported, then retry.
Mailing list cannot be unsubscribed to a deleted conversation. Unsubscribe request targets a conversation that is deleted. Use an active conversation and retry.
Mailing list cannot be unsubscribed to a deleted ticket. Unsubscribe request targets a ticket that is deleted. Use an active ticket and retry.
Mailing list cannot be unsubscribed to a spam conversation. Unsubscribe request targets a conversation marked as spam. Use a non-spam conversation or correct the spam state if supported, then retry.
Mailing list cannot be unsubscribed to a spam ticket. Unsubscribe request targets a ticket marked as spam. Use a non-spam ticket or correct the spam state if supported, then retry.

Troubleshooting (when Mailchimp operations fail)

An API request fails with Email ID is required.

  • Confirm the request payload includes the email ID field.
  • Confirm the email ID field is not empty or null.

An API request fails with Invalid email ID

  • Confirm the email ID is a valid email-formatted value.
  • Remove leading/trailing spaces and confirm the value is not malformed.

Subscribe/unsubscribe fails due to blocked/deleted/spam states

  • Check the source record state:
    • Contact: blocked or deleted
    • Conversation: deleted or spam
    • Ticket: deleted or spam
  • Retry only after using an eligible record state, because the integration rejects these states.

Frequently Asked Questions

  1. What does Email ID is required. mean in the Mailchimp integration?
    The Mailchimp integration request is missing the required email id field. Add the field to the request payload and retry.

  2. What causes Invalid email ID?
    The provided email id value fails validation (malformed or not in the expected format). Correct the value and retry.

  3. Can I subscribe a blocked contact to a Mailchimp mailing list?
    No. The integration rejects the request with Mailing list cannot be subscribed to a blocked contact.

  4. Can I unsubscribe a deleted contact from a Mailchimp mailing list?
    No. The integration rejects the request with Mailing list cannot be unsubscribed from a deleted contact. Use an active contact record.

  5. Why do conversation- and ticket-based operations fail when the record is spam?
    The integration does not allow subscribe/unsubscribe actions for conversations or tickets marked as spam. Use a non-spam record (or correct the spam state if your operational process supports that).

  6. Why do conversation- and ticket-based operations fail when the record is deleted?
    Deleted conversations and deleted tickets are not eligible for mailing list changes. Use an active record.
Attachments
Was this article useful?
Like
Dislike
Help us improve this page
Please provide feedback or comments
Comments (0)
Access denied
Access denied
Access denied
Access denied

No articles or sections found
No articles or sections found