Mailchimp Transactional

Provides integration with Mailchimp Transactional to send email and manage messages, templates, senders, tags, suppression lists, metadata, schedules, and webhooks.

Revision History

0.0.0.3 - Initial release.
0.0.0.4 - Added Workflow cancellation support.

Connection

Use this Connection to store the API key used by all Mailchimp Transactional Node methods.

Property Type Description
API Key Masked Mailchimp Transactional API key.

Setup Notes

  1. Open the Mailchimp Transactional app and select Settings.
  2. In the API Keys section, click Create New Key and enter a description for the key.
  3. Copy the generated key immediately and store it securely. Mailchimp does not display the key again after you finish creating it.
  4. In Flowgear, enter the key in API Key.
  5. Test the Connection. The test calls the side-effect-free /users/ping2 operation.

Methods

The Node groups its curated Mailchimp Transactional operations into query, send, create, update, delete, and action Methods.

Query

Queries supported Mailchimp Transactional resources, including messages, templates, senders, tags, suppression lists, metadata, and webhooks.

Parameter Type Description
Connection Connection Mailchimp Transactional Connection profile.
OperationId String Query operation selected from the template list.
Options Object Structured request values for the selected operation.
Return Type Description
Response Array Provider-shaped rows without Flowgear result metadata. Direct arrays return one row per item, and an empty array returns no rows.

Send

Sends structured transactional messages or messages based on native Mailchimp Transactional templates.

Parameter Type Description
Connection Connection Mailchimp Transactional Connection profile.
OperationId String Send operation selected from the template list.
Items Array Structured send requests processed one item at a time.
Return Type Description
Response Array Recipient result rows containing the provider status and nested Flowgear result metadata.

Create

Creates supported allowlist, rejection-list, metadata, template, and webhook resources.

Parameter Type Description
Connection Connection Mailchimp Transactional Connection profile.
OperationId String Create operation selected from the template list.
Items Array Structured create requests processed one item at a time.
Return Type Description
Response Array Result rows containing the provider payload and nested Flowgear result metadata.

Update

Updates supported metadata, template, and webhook resources.

Parameter Type Description
Connection Connection Mailchimp Transactional Connection profile.
OperationId String Update operation selected from the template list.
Items Array Structured update requests processed one item at a time.
Return Type Description
Response Array Result rows containing the provider payload and nested Flowgear result metadata.

Delete

Deletes supported allowlist, rejection-list, metadata, template, and webhook resources.

Parameter Type Description
Connection Connection Mailchimp Transactional Connection profile.
OperationId String Delete operation selected from the template list.
Items Array Structured delete requests processed one item at a time.
Return Type Description
Response Array Result rows containing the provider payload and nested Flowgear result metadata.

Action

Parses MIME messages, cancels or reschedules scheduled messages, and publishes or renders templates.

Parameter Type Description
Connection Connection Mailchimp Transactional Connection profile.
OperationId String Action operation selected from the template list.
Items Array Structured action requests processed one item at a time.
Return Type Description
Response Array Result rows containing the provider payload and nested Flowgear result metadata.

Usage Notes

  • Select a template before configuring Options or Items. The selected template supplies the request and response structure for its operation.
  • Enter string-list values as comma-separated text, e.g. transactional,welcome,onboarding. The Node converts them to provider JSON arrays.
  • Query executes its provider request before the Node invoke completes. Mailchimp Transactional does not provide a pagination continuation; messages/search.limit only limits the returned array.
  • Send, Create, Update, Delete, and Action execute the first non-null Items value before the Node invoke completes, then process later items as the Workflow consumes the response stream. An empty input makes no provider call.
  • Only query and Connection-test requests retry 429, 500, or 503 responses. Side-effecting requests are not replayed automatically.
  • For Send, the provider statuses sent, queued, and scheduled produce successful result rows. The statuses rejected and invalid produce failed result rows even when the HTTP request succeeds.
  • The Node redacts the configured API Key from errors, result rows, and Flowgear.Request.
  • The curated surface excludes raw MIME delivery, SMS, exports, inbound routing, dedicated IP administration, subaccounts, tracking-domain administration, and Mailchimp Marketing templates.

See also