Delete Contacts with Twilio SendGrid API on New Zapier Step Triggered (Instant) from Typebot API

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

Trigger workflow on

New Zapier Step Triggered (Instant) from the Typebot API

Next, do this

Delete Contacts 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 Typebot 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 Zapier Step Triggered (Instant) trigger
1. Connect your Typebot account
2. Select a Workspace ID
3. Select a Typebot ID
4. Select a Block ID
Configure the Delete Contacts action
1. Connect your Twilio SendGrid account
2. Configure Delete All Contacts?
3. Optional- Select one or more Contact IDs
4. Optional- Select one or more Contact 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 Zapier Step Triggered (Instant) on Typebot

Description:Emit new event when a zapier step is triggered. [See the docs](https://docs.typebot.io/api/subscribe-to-webhook-block)

Version:0.0.1

Key:typebot-zapier-step-triggered

View on GitHub

Typebot Overview#

Typebot is a conversational form builder that allows you to create interactive and engaging forms for data collection. With Typebot API on Pipedream, you can automate the processing of form submissions, synchronize data with other services, and trigger customized workflows. Utilize the data gathered from Typebot in real-time, enrich it with other services, and streamline processes like lead generation, surveys, and feedback collection.

Trigger Code#

import app from "../../typebot.app.mjs";

export default {
  key: "typebot-zapier-step-triggered",
  name: "New Zapier Step Triggered (Instant)",
  description: "Emit new event when a zapier step is triggered. [See the docs](https://docs.typebot.io/api/subscribe-to-webhook-block)",
  type: "source",
  version: "0.0.1",
  dedupe: "unique",
  props: {
    app,
    db: "$.service.db",
    http: "$.interface.http",
    workspaceId: {
      propDefinition: [
        app,
        "workspaceId",
      ],
    },
    typebotId: {
      propDefinition: [
        app,
        "typebotId",
        ({ workspaceId }) => ({
          workspaceId,
        }),
      ],
    },
    blockId: {
      propDefinition: [
        app,
        "blockId",
        ({ typebotId }) => ({
          typebotId,
        }),
      ],
    },
  },
  hooks: {
    async activate() {
      const {
        typebotId,
        blockId,
        http: { endpoint: url },
      } = this;
      await this.app.subscribeToWebhookBlock({
        typebotId,
        blockId,
        data: {
          url,
        },
      });
    },
    async deactivate() {
      const {
        typebotId,
        blockId,
      } = this;
      await this.app.unsubscribeFromWebhookBlock({
        typebotId,
        blockId,
      });
    },
  },
  methods: {
    generateMetadata(resource) {
      const ts = Date.parse(resource.submittedAt);
      return {
        id: ts,
        ts,
        summary: `New Step Submitted at ${resource.submittedAt}`,
      };
    },
  },
  async run({ body }) {
    const meta = this.generateMetadata(body);
    this.$emit(body, meta);
  },
};

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
Typebot	`app`	`app`	This component uses the Typebot 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.
Workspace ID	`workspaceId`	`string`	Select a value from the drop down menu.
Typebot ID	`typebotId`	`string`	Select a value from the drop down menu.
Block ID	`blockId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

To retrieve your API token,

Navigate to your Typebot account and sign in
Go to “Settings & Members” > “My account” > “API tokens”

About Typebot#

Typebot gives you powerful blocks to create unique chat experiences. Embed them anywhere on your web/mobile apps and start collecting results like magic.

Action#

Delete Contacts on Twilio SendGrid

Description:Allows you to delete one or more contacts. [See the docs here](https://docs.sendgrid.com/api-reference/contacts/delete-contacts)

Version:0.0.3

Key:sendgrid-delete-contacts

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-delete-contacts",
  name: "Delete Contacts",
  description: "Allows you to delete one or more contacts. [See the docs here](https://docs.sendgrid.com/api-reference/contacts/delete-contacts)",
  version: "0.0.3",
  type: "action",
  props: {
    ...common.props,
    deleteAllContacts: {
      propDefinition: [
        common.props.sendgrid,
        "deleteAll",
      ],
      label: "Delete All Contacts?",
      description: "This parameter allows you to delete all of your contacts. This can not be used with the `ids` parameter.",
    },
    contactIds: {
      propDefinition: [
        common.props.sendgrid,
        "contactIds",
      ],
    },
    contactEmails: {
      propDefinition: [
        common.props.sendgrid,
        "contactEmail",
      ],
      type: "string[]",
      label: "Contact Emails",
      description: "Array of email addresses to be deleted.",
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      deleteAllContacts,
      contactIds = [],
      contactEmails = [],
    } = this;

    if (deleteAllContacts && (contactIds || contactEmails)) {
      throw new Error("If `deleteAllContacts` is selected, cannot select `contactIds` or `contactEmails`");
    }

    for (const email of contactEmails) {
      const { result } = await this.sendgrid.searchContacts(`email like '${email}'`);
      const id = result[0]?.id;
      if (!contactIds.includes(id)) {
        contactIds.push(id);
      }
    }
    const resp = await this.sendgrid.deleteContacts(deleteAllContacts, contactIds);
    $.export("$summary", `Successfully deleted ${contactIds.length} contact(s)`);
    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.
Delete All Contacts?	`deleteAllContacts`	`boolean`	This parameter allows you to delete all of your contacts. This can not be used with the `ids` parameter.
Contact IDs	`contactIds`	`string[]`	Select a value from the drop down menu.
Contact Emails	`contactEmails`	`string[]`	Select a value from the drop down menu.

Action Authentication#

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

About Twilio SendGrid#

Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.