Create Campaign with Elastic Email API

Pipedream makes it easy to connect APIs for Elastic Email and 2,900+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Create Campaign with the Elastic Email 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#

Create a workflow to Create Campaign with the Elastic Email API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Create Campaign action
1. Connect your Elastic Email account
2. Configure Campaign Name
3. Configure From
4. Optional- Select one or more Recipient List Names
5. Optional- Select one or more Recipient Segment Names
6. Configure Reply To
7. Select a Campaign Status
8. Optional- Configure Subject
9. Optional- Select a Template Name
10. Optional- Select one or more Exclude Recipient List Names
11. Optional- Select one or more Exclude Recipient Segment Names
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Integrations#

Create Campaign with Elastic Email API on New Requests (Payload Only) from HTTP / Webhook API

HTTP / Webhook + Elastic Email

Try it

Create Campaign with Elastic Email API on New Submission from Typeform API

Typeform + Elastic Email

Try it

Create Campaign with Elastic Email API on New Submission (Instant) from Jotform API

Jotform + Elastic Email

Try it

Create Campaign with Elastic Email API on New Download Counts from npm API

npm + Elastic Email

Try it

Create Campaign with Elastic Email API on New Activity Created Event from Strava API

Strava + Elastic Email

Try it

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is 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.

Create Campaign on Elastic Email

Description:Create a campaign in an Elastic Email account. [See the documentation](https://elasticemail.com/developers/api-documentation/rest-api#operation/campaignsPost)

Version:0.0.1

Key:elastic_email-create-campaign

View on GitHub

Code#

import app from "../../elastic_email.app.mjs";
import { ConfigurationError } from "@pipedream/platform";
import { isValidEmailFormat } from "../../common/utils.mjs";

export default {
  key: "elastic_email-create-campaign",
  name: "Create Campaign",
  description: "Create a campaign in an Elastic Email account. [See the documentation](https://elasticemail.com/developers/api-documentation/rest-api#operation/campaignsPost)",
  version: "0.0.1",
  type: "action",
  annotations: {
    destructiveHint: false,
    openWorldHint: true,
    readOnlyHint: false,
  },
  props: {
    app,
    name: {
      type: "string",
      label: "Campaign Name",
      description: "The name of the campaign",
    },
    from: {
      type: "string",
      label: "From",
      description: "Your e-mail with an optional name (e.g.: `email@domain.com` or `John Doe <email@domain.com>`)",
    },
    recipientListNames: {
      propDefinition: [
        app,
        "listNames",
      ],
      label: "Recipient List Names",
      description: "Names of lists from your Account to read recipients from",
    },
    recipientSegmentNames: {
      propDefinition: [
        app,
        "segmentNames",
      ],
      label: "Recipient Segment Names",
      description: "Names of segments from your Account to read recipients from",
      optional: true,
    },
    replyTo: {
      type: "string",
      label: "Reply To",
      description: "To what address should the recipients reply to (e.g. `email@domain.com` or `John Doe <email@domain.com>`)",
    },
    status: {
      propDefinition: [
        app,
        "campaignStatus",
      ],
    },
    subject: {
      type: "string",
      label: "Subject",
      description: "Default subject of email",
      optional: true,
    },
    templateName: {
      propDefinition: [
        app,
        "templateName",
      ],
      optional: true,
    },
    excludeRecipientListNames: {
      propDefinition: [
        app,
        "listNames",
      ],
      label: "Exclude Recipient List Names",
      description: "Names of lists from your Account to exclude from the campaign",
    },
    excludeRecipientSegmentNames: {
      propDefinition: [
        app,
        "segmentNames",
      ],
      label: "Exclude Recipient Segment Names",
      description: "Names of segments from your Account to exclude from the campaign",
      optional: true,
    },
  },
  async run({ $ }) {
    if (this.from && !isValidEmailFormat(this.from)) {
      throw new ConfigurationError("Invalid email format for 'From'");
    }
    if (this.replyTo && !isValidEmailFormat(this.replyTo)) {
      throw new ConfigurationError("Invalid email format for 'Reply To'");
    }

    if (!this.recipientListNames && !this.recipientSegmentNames) {
      throw new ConfigurationError("You must provide at least one list or segment to read recipients from");
    }

    const response = await this.app.createCampaign({
      $,
      data: {
        Name: this.name,
        Recipients: {
          ListNames: this.recipientListNames,
          SegmentNames: this.recipientSegmentNames,
        },
        Content: [
          {
            From: this.from,
            ReplyTo: this.replyTo,
            Subject: this.subject,
            TemplateName: this.templateName,
          },
        ],
        Status: this.status,
        ExcludeRecipients: this.excludeRecipientListNames || this.excludeRecipientSegmentNames
          ? {
            ListNames: this.excludeRecipientListNames,
            SegmentNames: this.excludeRecipientSegmentNames,
          }
          : undefined,
      },
    });
    $.export("$summary", "Campaign created successfully");
    return response;
  },
};

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
Elastic Email	`app`	`app`	This component uses the Elastic Email app.
Campaign Name	`name`	`string`	The name of the campaign
From	`from`	`string`	Your e-mail with an optional name (e.g.: `email@domain.com` or `John Doe <email@domain.com>`)
Recipient List Names	`recipientListNames`	`string[]`	Select a value from the drop down menu.
Recipient Segment Names	`recipientSegmentNames`	`string[]`	Select a value from the drop down menu.
Reply To	`replyTo`	`string`	To what address should the recipients reply to (e.g. `email@domain.com` or `John Doe <email@domain.com>`)
Campaign Status	`status`	`string`	Select a value from the drop down menu:`DeletedActiveProcessingSendingCompletedPausedCancelledDraft`
Subject	`subject`	`string`	Default subject of email
Template Name	`templateName`	`string`	Select a value from the drop down menu.
Exclude Recipient List Names	`excludeRecipientListNames`	`string[]`	Select a value from the drop down menu.
Exclude Recipient Segment Names	`excludeRecipientSegmentNames`	`string[]`	Select a value from the drop down menu.