Add Email to Global Suppression with Twilio SendGrid API on New Scheduled Interview from Greenhouse API

Pipedream makes it easy to connect APIs for Twilio SendGrid, Greenhouse and 2,400+ other apps remarkably fast.

Trigger workflow on

New Scheduled Interview from the Greenhouse API

Next, do this

Add Email to Global Suppression with the Twilio SendGrid 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 Greenhouse trigger and Twilio SendGrid action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Scheduled Interview trigger
1. Connect your Greenhouse account
2. Configure timer
3. Configure Starts After
4. Configure Ends Before
Configure the Add Email to Global Suppression action
1. Connect your Twilio SendGrid account
2. Configure Recipient Emails
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 Scheduled Interview on Greenhouse

Description:Emit new event when a new interview is scheduled within a specific time period.

Version:0.0.1

Key:greenhouse-new-scheduled-interview

View on GitHub

Greenhouse Overview#

The Greenhouse API offers a powerful suite of tools for automating and enhancing the recruitment process. It allows you to programmatically access candidate information, job listings, scorecards, and scheduling details, which opens a myriad of possibilities for streamlining recruiting workflows. By leveraging the Greenhouse API on Pipedream, you can automate repetitive tasks, integrate with other HR systems, analyze recruitment data, and build custom event-driven workflows to improve the efficiency and effectiveness of your hiring process.

Trigger Code#

import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
import greenhouse from "../../greenhouse.app.mjs";
import sampleEmit from "./test-event.mjs";

export default {
  key: "greenhouse-new-scheduled-interview",
  name: "New Scheduled Interview",
  description: "Emit new event when a new interview is scheduled within a specific time period.",
  version: "0.0.1",
  type: "source",
  dedupe: "unique",
  props: {
    greenhouse,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    startsAfter: {
      type: "string",
      label: "Starts After",
      description: "Only return scheduled interviews scheduled to start at or after this timestamp. Timestamps must be in in [ISO-8601](https://developers.greenhouse.io/harvest.html#general-considerations) format.",
    },
    endsBefore: {
      type: "string",
      label: "Ends Before",
      description: "Only return scheduled interviews scheduled to end before this timestamp. Timestamps must be in in [ISO-8601](https://developers.greenhouse.io/harvest.html#general-considerations) format.",
    },
  },
  methods: {
    _getLastId() {
      return this.db.get("lastId") || 0;
    },
    _setLastId(id) {
      this.db.set("lastId", id);
    },
    generateMeta(interview) {
      return {
        id: interview.id,
        summary: `New Interview Scheduled: ${interview.id}`,
        ts: Date.parse(interview.updated_at),
      };
    },
    async startEvent(maxResults) {
      const lastId = this._getLastId();
      const response = this.greenhouse.paginate({
        fn: this.greenhouse.listInterviews,
        params: {
          starts_after: this.startsAfter,
          ends_before: this.endsBefore,
        },
        maxResults,
      });

      let responseArray = [];
      for await (const item of response) {
        responseArray.push(item);
      }

      responseArray.sort((a, b) => b.id - a.id);
      responseArray.filter((item) => item.id > lastId);

      if (responseArray.length) this._setLastId(responseArray[0].id);

      for (const item of responseArray.reverse()) {
        this.$emit(item, this.generateMeta(item));
      }
    },
  },
  hooks: {
    async deploy() {
      await this.startEvent(25);
    },
  },
  async run() {
    await this.startEvent();
  },
  sampleEmit,
};

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
Greenhouse	`greenhouse`	`app`	This component uses the Greenhouse app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Starts After	`startsAfter`	`string`	Only return scheduled interviews scheduled to start at or after this timestamp. Timestamps must be in in ISO-8601 format.
Ends Before	`endsBefore`	`string`	Only return scheduled interviews scheduled to end before this timestamp. Timestamps must be in in ISO-8601 format.

Trigger Authentication#

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

In order to create a Harvest API key, a user must be granted the “Can manage ALL organization’s API Credentials” in the “Developer permission” section. That user can then go Configure >> Dev Center >> API Credential Management as described in Harvest API Introduction.

About Greenhouse#

Talent Acquisition suite built for structured hiring

Action#

Add Email to Global Suppression on Twilio SendGrid

Description:Allows you to add one or more email addresses to the global suppressions group. [See the docs here](https://sendgrid.api-docs.io/v3.0/suppressions-global-suppressions/add-recipient-addresses-to-the-global-suppression-group)

Version:0.0.4

Key:sendgrid-add-email-to-global-suppression

View on GitHub

Twilio SendGrid Overview#

The Twilio SendGrid API opens up a world of possibilities for email automation, enabling you to send emails efficiently and track their performance. With this API, you can programmatically create and send personalized email campaigns, manage contacts, and parse inbound emails for data extraction. When you harness the power of Pipedream, you can connect SendGrid to hundreds of other apps to automate workflows, such as triggering email notifications based on specific actions, syncing email stats with your analytics, or handling incoming emails to create tasks or tickets.

Action Code#

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

export default {
  ...common,
  key: "sendgrid-add-email-to-global-suppression",
  name: "Add Email to Global Suppression",
  description: "Allows you to add one or more email addresses to the global suppressions group. [See the docs here](https://sendgrid.api-docs.io/v3.0/suppressions-global-suppressions/add-recipient-addresses-to-the-global-suppression-group)",
  version: "0.0.4",
  type: "action",
  props: {
    ...common.props,
    recipientEmails: {
      type: "string[]",
      label: "Recipient Emails",
      description: "An array of email addresses to be added to the global suppressions group. Example `[\"email1@example.com\",\"email2@example.com\"]`",
    },
  },
  async run({ $ }) {
    const resp = await this.sendgrid.addEmailToGlobalSuppression(this.recipientEmails);
    $.export("$summary", "Successfully added emails to global suppressions group");
    return resp;
  },
};

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
Twilio SendGrid	`sendgrid`	`app`	This component uses the Twilio SendGrid app.
Recipient Emails	`recipientEmails`	`string[]`	An array of email addresses to be added to the global suppressions group. Example `["email1@example.com","email2@example.com"]`

Add Email to Global Suppression with Twilio SendGrid API on New Scheduled Interview from Greenhouse API

Pipedream makes it easy to connect APIs for Twilio SendGrid, Greenhouse and 2,400+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,400+apps by most popular

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