Send Single Email with SMTP2GO API on New or Updated List Segment from Mailchimp API

Pipedream makes it easy to connect APIs for SMTP2GO , Mailchimp and 2,800+ other apps remarkably fast.

Trigger workflow on

New or Updated List Segment from the Mailchimp API

Next, do this

Send Single Email with the SMTP2GO API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Mailchimp trigger and SMTP2GO action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New or Updated List Segment trigger
1. Connect your Mailchimp account
2. Configure timer
3. Select a Audience List Id
4. Select a Watch for new created or updated segments?
5. Configure Include subscribers from Mailchimp Transactional?
Configure the Send Single Email action
1. Connect your SMTP2GO account
2. Configure Subject
3. Optional- Configure HTML Body
4. Optional- Configure Text Body
5. Configure "From" email address
6. Configure Recipient email address(es)
7. Optional- Configure CC email address(es)
8. Optional- Configure BCC email address(es)
9. Optional- Configure "Reply To" email address
10. Optional- Configure Custom Headers
11. Optional- Configure Attachments
12. Optional- Configure Ignore Failures
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger#

New or Updated List Segment on Mailchimp

Description:Emit new event when segment is either created or updated.

Version:0.0.2

Key:mailchimp-new-or-updated-list-segment

View on GitHub

Mailchimp Overview#

The Mailchimp API taps into the heart of your email marketing efforts, allowing you to manage subscribers, campaigns, and reports. With the API, you can automate tasks like syncing subscriber lists, segmenting contacts based on behavior, and personalizing email content to match user profiles. It's a powerful tool for marketers looking to fine-tune their email strategy and maximize engagement.

Trigger Code#

import common from "../common/timer-based.mjs";
import constants from "../constants.mjs";

export default {
  ...common,
  key: "mailchimp-new-or-updated-list-segment",
  name: "New or Updated List Segment",
  description: "Emit new event when segment is either created or updated.",
  version: "0.0.2",
  type: "source",
  dedupe: "unique",
  props: {
    ...common.props,
    listId: {
      propDefinition: [
        common.props.mailchimp,
        "listId",
      ],
      description: "The unique ID of the audience list which you'd like to watch for new or updated segments",
    },
    watchFor: {
      type: "string",
      label: "Watch for new created or updated segments?",
      description: "If set to `Created`, it will include new created segments only.  When set to `Updated`, it will only include recently updated segments.",
      options: constants.SEGMENT_WATCH_TYPES,
      optional: false,
    },
    includeTransactional: {
      propDefinition: [
        common.props.mailchimp,
        "includeTransactional",
      ],
    },
  },
  hooks: {
    async deploy() {
      // Emits sample events on the first run during deploy.
      const config = {
        count: 10,
        offset: 0,
      };
      const segments = this.watchFor === "Created"
        ? await this.mailchimp.getAudienceSegmentsByCreatedDate(this.listId, config)
        : await this.mailchimp.getAudienceSegmentsByUpdatedDate(this.listId, config);
      if (!segments?.length) {
        throw new Error("No segment data available");
      }
      const relevantDate = this.watchFor === "Created" ?
        segments[0].created_at
        : segments[0].updated_at;
      segments.forEach(this.processEvent);
      this.setDbServiceVariable("lastRelevantDate", relevantDate);
    },
  },
  methods: {
    ...common.methods,
    generateMeta(eventPayload) {
      if (this.watchFor === "Created") {
        return {
          id: eventPayload.id,
          summary: `A new segment "${eventPayload.name}" was created.`,
          ts: Date.parse(eventPayload.created_at),
        };
      } else {
        const ts = Date.parse(eventPayload.updated_at);
        return {
          id: `${eventPayload.id}${ts}`,
          summary: `Segment "${eventPayload.name}" was updated.`,
          ts,
        };
      }
    },
  },
  async run() {
    let startDateTime = this.getDbServiceVariable("lastRelevantDate");
    const endDateTime = (new Date).toISOString();
    let segments;
    let offset = 0;
    const pageSize = constants.PAGE_SIZE;
    const config = {
      count: pageSize,
      endDateTime,
    };
    do {
      config.offset = offset;
      config.startDateTime = startDateTime;
      segments = this.watchFor === "Created"
        ? segments = await this.mailchimp.getAudienceSegmentsByCreatedDate(this.listId, config)
        : segments = await this.mailchimp.getAudienceSegmentsByUpdatedDate(this.listId, config);
      if (!segments?.length) {
        return;
      }
      segments.forEach(this.processEvent);
      startDateTime = this.watchFor === "Created" ?
        segments[0].created_at
        : segments[0].updated_at;
      this.setDbServiceVariable("lastRelevantDate", startDateTime);
      offset = offset + segments.length;
    } while (segments.length === pageSize);
  },
};

Trigger Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Mailchimp	`mailchimp`	`app`	This component uses the Mailchimp app.
	`timer`	`$.interface.timer`
Audience List Id	`listId`	`string`	Select a value from the drop down menu.
Watch for new created or updated segments?	`watchFor`	`string`	Select a value from the drop down menu:`CreatedUpdated`
Include subscribers from Mailchimp Transactional?	`includeTransactional`	`boolean`	If set to `true`, it will include subscribers from Mailchimp Marketing and Mailchimp Transactional, formerly Mandrill. When set to `false`, it will include subscribers from Mailchimp Marketing only.

Trigger Authentication#

Mailchimp uses OAuth authentication. When you connect your Mailchimp account, Pipedream will open a popup window where you can sign into Mailchimp and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Mailchimp API.

Pipedream requests the following authorization scopes when you connect your account:

About Mailchimp#

Mailchimp is a marketing automation and email marketing platform.

Action#

Send Single Email on SMTP2GO

Description:Send a single email with SMTP2GO [(See docs here)](https://apidoc.smtp2go.com/documentation/#/POST%20/email/send)

Version:0.0.2

Key:smtp2go-send-single-email

View on GitHub

SMTP2GO Overview#

SMTP2GO is an email delivery service that offers a robust SMTP API for sending emails. With the SMTP2GO API, you can programmatically send emails, get detailed reports on email delivery, and manage your sender reputation. It's useful for transactional emails, where reliability and deliverability are paramount, such as sending receipts, notifications, or password resets. When paired with Pipedream, SMTP2GO becomes a powerhouse, enabling you to create intricate automated workflows combining email capabilities with hundreds of other apps.

Action Code#

import smtp2go from "../../app/smtp2go.app.mjs";
import common from "../common.mjs";
export default {
    ...common,
    key: "smtp2go-send-single-email",
    name: "Send Single Email",
    description: "Send a single email with SMTP2GO [(See docs here)](https://apidoc.smtp2go.com/documentation/#/POST%20/email/send)",
    version: "0.0.2",
    type: "action",
    props: {
        smtp2go,
        subject: {
            type: "string",
            label: "Subject",
            description: "Email subject.",
        },
        htmlBody: {
            type: "string",
            label: "HTML Body",
            description: `HTML email message.
        \\
        **Required** if no \`Text Body\` is specified.`,
            optional: true,
        },
        textBody: {
            type: "string",
            label: "Text Body",
            description: `Plain text email message.
        \\
        **Required** if no \`HTML Body\` is specified.`,
            optional: true,
        },
        // The above props are intentionally placed first
        ...common.props,
    },
    async run({ $ }) {
        const data = {
            ...this.getActionRequestCommonData(),
            subject: this.subject,
            html_body: this.htmlBody,
            text_body: this.textBody,
        };
        if (!data.html_body && !data.text_body) {
            throw new Error("You must have EITHER a text body or an html body. Neither were provided.");
        }
        const response = await this.smtp2go.sendSingleEmail($, data, this.ignoreFailures);
        $.export("$summary", `Sent email successfully with email ID ${response.data.email_id}`);
        return response;
    },
};

Action Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

Label	Prop	Type	Description
SMTP2GO	`smtp2go`	`app`	This component uses the SMTP2GO app.
Subject	`subject`	`string`	Email subject.
HTML Body	`htmlBody`	`string`	HTML email message. Required if no `Text Body` is specified.
Text Body	`textBody`	`string`	Plain text email message. Required if no `HTML Body` is specified.
"From" email address	`fromEmail`	`string`	The sender email address. To include a name, use the format 'Full Name <sender@domain.com>' for the address.
Recipient email address(es)	`toEmail`	`string[]`	Recipient email address. Max 50.
CC email address(es)	`ccEmail`	`string[]`	Cc recipient email address. Max 50.
BCC email address(es)	`bccEmail`	`string[]`	Bcc recipient email address. Max 50.
"Reply To" email address	`replyTo`	`string`	Reply To override email address. Defaults to the Reply To set in the sender signature.
Custom Headers	`customHeaders`	`string[]`	List of custom headers to include. Each attachment should be a string with the parameters separated by a pipe character `\|`, in the format: `header\|value`. Alternatively, you can pass a string representing an object. Both parameters are required: `header` - the header key name, i.e. `some-header` `value` - the string value of the header, i.e. `the-value` Example with pipe-separated parameters: `some-custom-header\|the-value` Example with JSON-stringified object: `{"header":"some-custom-header","value":"the-value"}`
Attachments	`attachments`	`string[]`	List of attachments to include. Each attachment should be a string with the parameters separated by a pipe character `\|`, in the format: `Name\|Content\|ContentType`. Alternatively, you can pass a string representing an object. All three parameters are required: `filename` - the filename with extension, i.e. `readme.txt` `fileblob` - the base64-encoded string with the binary data for the file, i.e. `dGVzdCBjb250ZW50` `mimetype` - the MIME content type, i.e. `text/plain` Example with pipe-separated parameters: `readme.txt\|dGVzdCBjb250ZW50\|text/plain` Example with JSON-stringified object: `{"filename":"readme.txt","fileblob":"dGVzdCBjb250ZW50","mimetype":"text/plain"}`
Ignore Failures	`ignoreFailures`	`boolean`	Should this action ignore failures to send an email?

Action Authentication#

SMTP2GO uses API keys for authentication. When you connect your SMTP2GO account, Pipedream securely stores the keys so you can easily authenticate to SMTP2GO APIs in both code and no-code steps.

To create your API keys,

Navigate to your SMTP2GO account and sign in
Go to ”Settings” > “API Keys”

Send Single Email with SMTP2GO API on New or Updated List Segment from Mailchimp API

Pipedream makes it easy to connect APIs for SMTP2GO , Mailchimp and 2,800+ other apps remarkably fast.

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

1-24of2,800+apps by most popular

1
-
24
of
2,800+
apps by most popular