Create Event with Salesforce (REST API) API on New Email Opened from Postmark API

Pipedream makes it easy to connect APIs for Salesforce (REST API), Postmark and 2,000+ other apps remarkably fast.

Trigger workflow on

New Email Opened from the Postmark API

Next, do this

Create Event with the Salesforce (REST API) API

No credit card required

▶

Watch us build a workflow

4 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Postmark trigger and Salesforce (REST API) action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Email Opened trigger
1. Connect your Postmark account
2. Configure Track first open only
Configure the Create Event action
1. Connect your Salesforce (REST API) account
2. Configure All-Day Event
3. Select one or more Accepted Event Invitee IDs
4. Configure Description
5. Configure Subject
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 Email Opened on Postmark

Description:Emit new event when an email is opened by a recipient [(See docs here)](https://postmarkapp.com/developer/webhooks/open-tracking-webhook)

Version:0.0.3

Key:postmark-new-email-opened

View on GitHub

Postmark Overview#

The Postmark API enables developers to easily integrate programmatic emailing into their applications. With the API, developers can create, send, and track transactional emails that are designed to enhance user experience and user engagement. The API also provides developers with access to powerful analytics and insights, such as open/click rates, spam complaints, bounces, and unsubscribes.

Trigger Code#

import common from "../common.mjs";

export default {
  ...common,
  key: "postmark-new-email-opened",
  name: "New Email Opened",
  description:
    "Emit new event when an email is opened by a recipient [(See docs here)](https://postmarkapp.com/developer/webhooks/open-tracking-webhook)",
  version: "0.0.3",
  type: "source",
  props: {
    ...common.props,
    postFirstOpenOnly: {
      type: "boolean",
      label: "Track first open only",
      description: `If enabled, an event will only be emitted the first time the recipient opens the email.
        \\
        Otherwise, the event will be emitted every time an open occurs.`,
    },
  },
  methods: {
    ...common.methods,
    getWebhookProps() {
      return {
        Triggers: {
          "Open": {
            "Enabled": true,
            "PostFirstOpenOnly": false,
          },
        },
      };
    },
    getSummary(body) {
      return `New email opened! MessageID - ${body.MessageID}`;
    },
  },
};

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
Postmark	`postmark`	`app`	This component uses the Postmark app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
N/A	`http`	`$.interface.http`	This component uses `$.interface.http` to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the `run()` method of the component.
Track first open only	`postFirstOpenOnly`	`boolean`	If enabled, an event will only be emitted the first time the recipient opens the email. Otherwise, the event will be emitted every time an open occurs.

Trigger Authentication#

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

About Postmark#

Postmark is a fast and reliable email delivery service that enables you to send transactional and marketing emails and get them to the inbox on time, every time.

Action#

Create Event on Salesforce (REST API)

Description:Creates an event, which represents an event in the calendar. See [Event SObject](https://developer.salesforce.com/docs/atlas.en-us.228.0.object_reference.meta/object_reference/sforce_api_objects_event.htm) and [Create Record](https://developer.salesforce.com/docs/atlas.en-us.228.0.api_rest.meta/api_rest/dome_sobject_create.htm)

Version:0.2.7

Key:salesforce_rest_api-create-event

View on GitHub

Salesforce (REST API) Overview#

The Salesforce (REST API) provides a powerful platform for creating and managing customer relationships with a wide array of features like data manipulation, querying, and complex automation. With Pipedream's serverless execution, you can create workflows that automate your sales processes, sync data with other platforms, enhance customer engagement, and trigger actions based on specific events. Dive into Salesforce data, streamline lead management, track customer interactions, and push or pull data to or from Salesforce seamlessly.

Action Code#

import salesforce from "../../salesforce_rest_api.app.mjs";
import {
  removeNullEntries, toSingleLineString,
} from "../../common/utils.mjs";

export default {
  key: "salesforce_rest_api-create-event",
  name: "Create Event",
  description: toSingleLineString(`
    Creates an event, which represents an event in the calendar.
    See [Event SObject](https://developer.salesforce.com/docs/atlas.en-us.228.0.object_reference.meta/object_reference/sforce_api_objects_event.htm)
    and [Create Record](https://developer.salesforce.com/docs/atlas.en-us.228.0.api_rest.meta/api_rest/dome_sobject_create.htm)
  `),
  version: "0.2.7",
  type: "action",
  props: {
    salesforce,
    IsAllDayEvent: {
      type: "boolean",
      label: "All-Day Event",
      description: "Indicates whether the ActivityDate field (true) or the ActivityDateTime field (false) is used to define the date or time of the event.",
      reloadProps: true,
    },
    AcceptedEventInviteeIds: {
      propDefinition: [
        salesforce,
        "AcceptedEventInviteeIds",
      ],
    },
    Description: {
      type: "string",
      label: "Description",
      description: "Contains a text description of the event. Limit: 32,000 characters.",
    },
    Subject: {
      type: "string",
      label: "Subject",
      description: "The subject line of the event, such as Call, Email, or Meeting. Limit: 255 characters.",
    },
  },
  async additionalProps() {
    const props = {};
    if (this.IsAllDayEvent) {
      props.ActivityDate = {
        type: "string",
        label: "Due Date Only (YYYY/MM/DD)",
        description: "Contains the event's due date if the IsAllDayEvent flag is set to true.",
      };
    } else {
      props.ActivityDateTime = {
        type: "string",
        label: "Due Date Time",
        description: "Contains the event's due date if the IsAllDayEvent flag is set to false. The time portion of this field is always transferred in the Coordinated Universal Time (UTC) time zone. Translate the time portion to or from a local time zone for the user or the application, as appropriate.",
      };
      props.DurationInMinutes = {
        type: "integer",
        label: "Duration in minutes",
        description: "Contains the event length, in minutes.",
      };
    }
    return props;
  },
  async run({ $ }) {
    const data = removeNullEntries({
      IsAllDayEvent: this.IsAllDayEvent,
      AcceptedEventInviteeIds: this.AcceptedEventInviteeIds,
      Description: this.Description,
      Subject: this.Subject,
      ActivityDate: this.ActivityDate && new Date(this.ActivityDate).toUTCString(),
      ActivityDateTime: this.ActivityDateTime,
      DurationInMinutes: this.DurationInMinutes,
    });
    const response = await this.salesforce.createEvent({
      $,
      data,
    });
    $.export("$summary", "Succcessfully created event");
    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
Salesforce (REST API)	`salesforce`	`app`	This component uses the Salesforce (REST API) app.
All-Day Event	`IsAllDayEvent`	`boolean`	Indicates whether the ActivityDate field (true) or the ActivityDateTime field (false) is used to define the date or time of the event.
Accepted Event Invitee IDs	`AcceptedEventInviteeIds`	`string[]`	Select a value from the drop down menu.
Description	`Description`	`string`	Contains a text description of the event. Limit: 32,000 characters.
Subject	`Subject`	`string`	The subject line of the event, such as Call, Email, or Meeting. Limit: 255 characters.

Action Authentication#

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

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

Create Event with Salesforce (REST API) API on New Email Opened from Postmark API

Pipedream makes it easy to connect APIs for Salesforce (REST API), Postmark and 2,000+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,000+apps by most popular

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