Send Email with Gmail API on Custom Webhook Events (Instant) from Trello API

Pipedream makes it easy to connect APIs for Gmail, Trello and 2,500+ other apps remarkably fast.

Trigger workflow on

Custom Webhook Events (Instant) from the Trello API

Next, do this

Send Email with the Gmail 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 Trello trigger and Gmail action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Custom Webhook Events (Instant) trigger
1. Connect your Trello account
2. Select a Board
3. Optional- Select one or more Event Types
4. Optional- Select one or more Lists
5. Optional- Select one or more Cards
Configure the Send Email action
1. Connect your Gmail account
2. Configure To
3. Optional- Configure Cc
4. Optional- Configure Bcc
5. Optional- Configure From Name
6. Optional- Select a From Email
7. Optional- Configure Reply To
8. Configure Subject
9. Configure Email Body
10. Optional- Select a Body Type
11. Optional- Configure Attachment Filenames
12. Optional- Configure Attachment URLs or Paths
13. Optional- Select a In Reply To
14. Optional- Select a Mime Type
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#

Custom Webhook Events (Instant) on Trello

Description:Emit new events for activity matching a board, event types, lists and/or cards.

Version:0.1.1

Key:trello-custom-webhook-events

View on GitHub

Trello Overview#

Trello's API lets you craft workflows around managing boards, lists, cards, and users. With Pipedream, you can automate Trello tasks, like syncing cards with external databases, updating checklists, and posting notifications to other platforms. It enables seamless connection with other apps, fostering productivity by automating routine board operations, card management, and team notifications.

Trigger Code#

import common from "../common/common-webhook.mjs";
import events from "../common/events.mjs";

export default {
  ...common,
  key: "trello-custom-webhook-events",
  name: "Custom Webhook Events (Instant)", /* eslint-disable-line pipedream/source-name */
  description: "Emit new events for activity matching a board, event types, lists and/or cards.",
  version: "0.1.1",
  type: "source",
  props: {
    ...common.props,
    board: {
      propDefinition: [
        common.props.app,
        "board",
      ],
    },
    eventTypes: {
      type: "string[]",
      label: "Event Types",
      optional: true,
      description: "Only emit events for the selected event types (e.g., `updateCard`).",
      options: events,
    },
    lists: {
      propDefinition: [
        common.props.app,
        "lists",
        (c) => ({
          board: c.board,
        }),
      ],
    },
    cards: {
      propDefinition: [
        common.props.app,
        "cards",
        (c) => ({
          board: c.board,
        }),
      ],
    },
  },
  methods: {
    ...common.methods,
    getSampleEvents() {
      const eventTypes = this.eventTypes?.length
        ? this.eventTypes.join(",")
        : null;
      return this.app.getBoardActivity({
        boardId: this.board,
        params: {
          filter: eventTypes,
        },
      });
    },
    getSortField() {
      return "date";
    },
    isCorrectEventType({ type }) {
      return (
        (type) &&
        (!this.eventTypes?.length ||
        this.eventTypes.includes(type))
      );
    },
    async isRelevant({ result: body }) {
      let listId = body.action?.data?.list?.id;
      const cardId = body.action?.data?.card?.id;
      // If listId not returned, see if we can get it from the cardId
      if (cardId && !listId) {
        const res = await this.app.getCardList({
          cardId,
        });
        listId = res.id;
      }
      return (
        (!this.lists?.length ||
          !listId ||
          this.lists.includes(listId)) &&
        (!this.cards?.length || !cardId || this.cards.includes(cardId))
      );
    },
    generateMeta(action) {
      const {
        id,
        type,
        date,
      } = action;
      return {
        id,
        summary: `New ${type} event`,
        ts: Date.parse(date),
      };
    },
  },
};

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
Trello	`app`	`app`	This component uses the Trello 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.
Board	`board`	`string`	Select a value from the drop down menu.
Event Types	`eventTypes`	`string[]`	Select a value from the drop down menu:`{ "label": "Add Attachment To Card", "value": "addAttachmentToCard" }{ "label": "Add Checklist To Card", "value": "addChecklistToCard" }{ "label": "Add Label To Card", "value": "addLabelToCard" }{ "label": "Add Member To Board", "value": "addMemberToBoard" }{ "label": "Add Member To Card", "value": "addMemberToCard" }{ "label": "Comment Card", "value": "commentCard" }{ "label": "Convert To Card From Check Item", "value": "convertToCardFromCheckItem" }{ "label": "Copy Card", "value": "copyCard" }{ "label": "Create Card", "value": "createCard" }{ "label": "Create Check Item", "value": "createCheckItem" }{ "label": "Create Label", "value": "createLabel" }{ "label": "Create List", "value": "createList" }{ "label": "Delete Attachment From Card", "value": "deleteAttachmentFromCard" }{ "label": "Delete Card", "value": "deleteCard" }{ "label": "Delete Check Item", "value": "deleteCheckItem" }{ "label": "Delete Comment", "value": "deleteComment" }{ "label": "Delete Label", "value": "deleteLabel" }{ "label": "Email Card", "value": "emailCard" }{ "label": "Move Card From Board", "value": "moveCardFromBoard" }{ "label": "Move Card To Board", "value": "moveCardToBoard" }{ "label": "Move List From Board", "value": "moveListFromBoard" }{ "label": "Move List To Board", "value": "moveListToBoard" }{ "label": "Remove Checklist From Card", "value": "removeChecklistFromCard" }{ "label": "Remove Label From Card", "value": "removeLabelFromCard" }{ "label": "Remove Member From Board", "value": "removeMemberFromBoard" }{ "label": "Remove Member From Card", "value": "removeMemberFromCard" }{ "label": "Update Board", "value": "updateBoard" }{ "label": "Update Card", "value": "updateCard" }{ "label": "Update Check Item", "value": "updateCheckItem" }{ "label": "Update Check Item State On Card", "value": "updateCheckItemStateOnCard" }{ "label": "Update Checklist", "value": "updateChecklist" }{ "label": "Update Comment", "value": "updateComment" }{ "label": "Update Label", "value": "updateLabel" }{ "label": "Update List", "value": "updateList" }`
Lists	`lists`	`string[]`	Select a value from the drop down menu.
Cards	`cards`	`string[]`	Select a value from the drop down menu.

Trigger Authentication#

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

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

readwrite

About Trello#

Trello is the flexible work management tool that empowers all teams to plan, track, and accomplish their work, their way.

Action#

Send Email on Gmail

Description:Send an email from your Google Workspace email account. [See the documentation](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/send)

Version:0.1.9

Key:gmail-send-email

View on GitHub

Gmail Overview#

By connecting your personal Gmail account to Pipedream, you'll be able to incorporate email into whatever you're building with any of the thousands of apps that are available on Pipedream.

Action Code#

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

export default {
  key: "gmail-send-email",
  name: "Send Email",
  description: "Send an email from your Google Workspace email account. [See the documentation](https://developers.google.com/gmail/api/reference/rest/v1/users.messages/send)",
  version: "0.1.9",
  type: "action",
  props: {
    gmail,
    to: {
      propDefinition: [
        gmail,
        "to",
      ],
    },
    cc: {
      propDefinition: [
        gmail,
        "cc",
      ],
    },
    bcc: {
      propDefinition: [
        gmail,
        "bcc",
      ],
    },
    fromName: {
      propDefinition: [
        gmail,
        "fromName",
      ],
    },
    fromEmail: {
      propDefinition: [
        gmail,
        "fromEmail",
      ],
    },
    replyTo: {
      propDefinition: [
        gmail,
        "replyTo",
      ],
    },
    subject: {
      propDefinition: [
        gmail,
        "subject",
      ],
    },
    body: {
      propDefinition: [
        gmail,
        "body",
      ],
    },
    bodyType: {
      propDefinition: [
        gmail,
        "bodyType",
      ],
    },
    attachmentFilenames: {
      propDefinition: [
        gmail,
        "attachmentFilenames",
      ],
    },
    attachmentUrlsOrPaths: {
      propDefinition: [
        gmail,
        "attachmentUrlsOrPaths",
      ],
    },
    inReplyTo: {
      propDefinition: [
        gmail,
        "message",
      ],
      label: "In Reply To",
      description: "Specify the `message-id` this email is replying to.",
      optional: true,
      reloadProps: true,
    },
    mimeType: {
      propDefinition: [
        gmail,
        "mimeType",
      ],
    },
  },
  additionalProps(existingProps) {
    const props = {};
    if (this.inReplyTo) {
      props.replyAll = {
        type: "boolean",
        label: "Reply All",
        description: "Set to `true` to send reply to emails in the \"From\", \"To\", \"CC\", and \"BCC\" (if available) of the original email",
        optional: true,
        reloadProps: true,
      };
    }
    existingProps.to.hidden = !!this.replyAll;
    existingProps.cc.hidden = !!this.replyAll;
    existingProps.bcc.hidden = !!this.replyAll;
    return props;
  },
  async run({ $ }) {
    this.attachmentFilenames = utils.parseArray(this.attachmentFilenames);
    this.attachmentUrlsOrPaths = utils.parseArray(this.attachmentUrlsOrPaths);
    if (this.attachmentFilenames?.length !== this.attachmentUrlsOrPaths?.length) {
      throw new ConfigurationError("Must specify the same number of `Attachment Filenames` and `Attachment URLs or Paths`");
    }
    const opts = await this.gmail.getOptionsToSendEmail($, this);
    const response = await this.gmail.sendEmail(opts);
    $.export("$summary", "Successfully sent the email");
    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
Gmail	`gmail`	`app`	This component uses the Gmail app.
To	`to`	`string[]`	Enter a single recipient's email or multiple emails as items in an array.
Cc	`cc`	`string[]`	Enter a single recipient's email or multiple emails as items in an array.
Bcc	`bcc`	`string[]`	Enter a single recipient's email or multiple emails as items in an array.
From Name	`fromName`	`string`	Specify the name that will be displayed in the "From" section of the email.
From Email	`fromEmail`	`string`	Select a value from the drop down menu.
Reply To	`replyTo`	`string`	Specify the email address that will appear on the "Reply-To" field, if different than the sender's email.
Subject	`subject`	`string`	Specify a subject for the email.
Email Body	`body`	`string`	Include an email body as either plain text or HTML. If HTML, make sure to set the "Body Type" prop to `html`.
Body Type	`bodyType`	`string`	Select a value from the drop down menu:`htmlplaintext`
Attachment Filenames	`attachmentFilenames`	`string[]`	Array of the names of the files to attach. Must contain the file extension (e.g. `.jpeg`, `.txt`). Use in conjuction with `Attachment URLs or Paths`.
Attachment URLs or Paths	`attachmentUrlsOrPaths`	`string[]`	Array of the URLs of the download links for the files, or the local paths (e.g. `/tmp/my-file.txt`). Use in conjuction with `Attachment Filenames`.
In Reply To	`inReplyTo`	`string`	Select a value from the drop down menu.
Mime Type	`mimeType`	`string`	Select a value from the drop down menu.

Action Authentication#

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

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

emailprofileopenidhttps://www.googleapis.com/auth/gmail.labelshttps://www.googleapis.com/auth/gmail.sendhttps://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.composehttps://www.googleapis.com/auth/gmail.settings.basic

Send Email with Gmail API on Custom Webhook Events (Instant) from Trello API

Pipedream makes it easy to connect APIs for Gmail, Trello and 2,500+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,500+apps by most popular

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