← GitHub + Front integrations

Import Message with Front API on New Card in Column (Classic Projects) from GitHub API

Pipedream makes it easy to connect APIs for Front, GitHub and 1000+ other apps remarkably fast.

Trigger workflow on
New Card in Column (Classic Projects) from the GitHub API
Next, do this
Import Message with the Front API
No credit card required
Into to Pipedream
Watch us build a workflow
Watch us build a workflow
7 min
Watch now ➜
Trusted by 250,000+ developers from startups to Fortune 500 companies:
Trusted by 250,000+ developers from startups to Fortune 500 companies

Developers Pipedream

Getting Started

This integration creates a workflow with a GitHub trigger and Front action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Select this integration
  2. Configure the New Card in Column (Classic Projects) trigger
    1. Connect your GitHub account
    2. Select a Repository
    3. Select a Project
    4. Select a Column
  3. Configure the Import Message action
    1. Connect your Front account
    2. Select a Inbox ID
    3. Configure Handle
    4. Optional- Configure Name
    5. Optional- Select a Author ID
    6. Configure To
    7. Optional- Configure CC
    8. Optional- Configure BCC
    9. Optional- Configure Subject
    10. Configure Body
    11. Select a Body Format
    12. Configure External ID
    13. Configure Created At
    14. Optional- Select a Type
    15. Select a Assignee ID
    16. Optional- Select one or more Tag IDs
    17. Optional- Select a Thread Ref
    18. Configure Is Inbound
    19. Optional- Configure Is Archive
    20. Optional- Configure Should Skip Rules
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. Turn on the trigger

Details

This integration uses pre-built, open source 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

Description:Emit new event when a (classic) project card is created or moved to a specific column. For Projects V2 use `New Issue with Status` trigger. [More information here](https://docs.github.com/en/issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-issues-and-pull-requests-to-a-project-board)
Version:0.1.5
Key:github-new-card-in-column

Trigger Code

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

export default {
  ...common,
  key: "github-new-card-in-column",
  name: "New Card in Column (Classic Projects)",
  description: "Emit new event when a (classic) project card is created or moved to a specific column. For Projects V2 use `New Issue with Status` trigger. [More information here](https://docs.github.com/en/issues/organizing-your-work-with-project-boards/tracking-work-with-project-boards/adding-issues-and-pull-requests-to-a-project-board)",
  version: "0.1.5",
  type: "source",
  props: {
    ...common.props,
    project: {
      propDefinition: [
        common.props.github,
        "project",
        (c) => ({
          repoFullname: c.repoFullname,
        }),
      ],
    },
    column: {
      propDefinition: [
        common.props.github,
        "column",
        (c) => ({
          project: c.project,
        }),
      ],
      withLabel: true,
    },
  },
  methods: {
    ...common.methods,
    getWebhookEvents() {
      return [
        "project_card",
      ];
    },
    getThisColumnLabel() {
      if (typeof this.column ===  "object") {
        return this.column.label;
      }
      return this.column;
    },
    getThisColumnValue() {
      if (typeof this.column ===  "object") {
        return this.column.value;
      }
      return this.column;
    },
    isCardInThisColumn(card) {
      const { column_id: columnId } = card;
      return columnId === this.getThisColumnValue();
    },
    generateMeta(card) {
      return {
        id: card.id,
        summary: `New card in ${this.getThisColumnLabel()}: ${card.note}`,
        ts: Date.parse(card.updated_at),
      };
    },
    async loadHistoricalEvents() {
      const cards = await this.github.getProjectCards({
        columnId: this.getThisColumnValue(),
        per_page: constants.HISTORICAL_EVENTS,
      });
      for (const card of cards) {
        await this.processCard(card);
      }
    },
    async processCard(card) {
      const meta = this.generateMeta(card);
      const issue = await this.github.getIssueFromProjectCard({
        repoFullname: this.repoFullname,
        cardId: card.id,
      });
      this.$emit({
        card,
        issue,
      }, meta);
    },
  },
  async run(event) {
    const card = event.body.project_card;
    if (!card) {
      console.log("No card in event. Skipping event.");
      return;
    }

    if (!this.isCardInThisColumn(card)) {
      console.log(`Card not in ${this.getThisColumnLabel()}. Skipping...`);
      return;
    }

    this.processCard(card);
  },
};

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.
LabelPropTypeDescription
GitHubgithubappThis component uses the GitHub app.
RepositoryrepoFullnamestringSelect a value from the drop down menu.
N/Adb$.service.dbThis component uses $.service.db to maintain state between component invocations.
N/Ahttp$.interface.httpThis 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.
ProjectprojectintegerSelect a value from the drop down menu.
ColumncolumnintegerSelect a value from the drop down menu.

Trigger Authentication

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

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

repoadmin:orgadmin:public_keyadmin:org_hookgistprojectnotificationsuserwrite:discussionwrite:packagesread:packagesadmin:repo_hook

About GitHub

Where the world builds software. Millions of developers and companies build, ship, and maintain their software on GitHub—the largest and most advanced development platform in the world.

Action

Description:Appends a new message into an inbox. [See the docs here](https://dev.frontapp.com/reference/import-inbox-message).
Version:0.1.3
Key:frontapp-import-message

Front Overview

With the Front API, you can build a variety of applications and integrations to
help you and your team manage your email inboxes. Here are a few examples of
what you can build:

  • A personalized email assistant that can help you triage and respond to emails
  • An integration with your CRM that automatically adds emails from customers to
    your CRM
  • A tool that flags important emails and sends you notifications about them
  • An app that helps you find emails from a specific sender or with a certain
    subject line
  • A script that archives all of your old emails

These are just a few examples of what you can build with the Front API – the
possibilities are really only limited by your imagination!

Action Code

import frontApp from "../../frontapp.app.mjs";
import utils from "../../common/utils.mjs";

export default {
  key: "frontapp-import-message",
  name: "Import Message",
  description: "Appends a new message into an inbox. [See the docs here](https://dev.frontapp.com/reference/import-inbox-message).",
  version: "0.1.3",
  type: "action",
  props: {
    frontApp,
    inboxId: {
      propDefinition: [
        frontApp,
        "inboxId",
      ],
    },
    handle: {
      type: "string",
      label: "Handle",
      description: "Handle used to reach the contact. Can be an email address, a twitter, handle, a phone number, custom handle ...",
    },
    name: {
      type: "string",
      label: "Name",
      description: "Name of the contact.",
      optional: true,
    },
    authorId: {
      propDefinition: [
        frontApp,
        "teammateId",
      ],
      label: "Author ID",
      description: "ID of the teammate who is the author of the message. Ignored if the message is inbound.",
      optional: true,
    },
    to: {
      propDefinition: [
        frontApp,
        "to",
      ],
    },
    cc: {
      propDefinition: [
        frontApp,
        "cc",
      ],
    },
    bcc: {
      propDefinition: [
        frontApp,
        "bcc",
      ],
    },
    subject: {
      type: "string",
      label: "Subject",
      description: "Subject of the message.",
      optional: true,
    },
    body: {
      type: "string",
      label: "Body",
      description: "Body of the message.",
    },
    bodyFormat: {
      propDefinition: [
        frontApp,
        "bodyFormat",
      ],
    },
    externalId: {
      type: "string",
      label: "External ID",
      description: "External identifier of the message. Front won't import two messages with the same external ID.",
    },
    createdAt: {
      type: "integer",
      label: "Created At",
      description: "Date at which the message has been sent or received. A timestamp is expected as in `1655507769`",
      default: Math.floor(Date.now() / 1000),
    },
    type: {
      type: "string",
      label: "Type",
      description: "Type of the message to import. Can be one of: `email`, `sms`, `intercom`, `custom`. (Default: `email`)",
      optional: true,
      options: [
        "email",
        "sms",
        "intercom",
        "custom",
      ],
    },
    assigneeId: {
      propDefinition: [
        frontApp,
        "teammateId",
      ],
      label: "Assignee ID",
      description: "ID of the teammate who will be assigned to the conversation.",
    },
    tags: {
      propDefinition: [
        frontApp,
        "tagIds",
      ],
      description: "List of tag names to add to the conversation (unknown tags will automatically be created)",
    },
    threadRef: {
      propDefinition: [
        frontApp,
        "threadRef",
      ],
    },
    isInbound: {
      type: "boolean",
      label: "Is Inbound",
      description: "Whether or not the message is received (inbound) or sent (outbound) by you",
    },
    isArchive: {
      type: "boolean",
      label: "Is Archive",
      description: "Whether or not the message should be directly archived once imported. (Default: true)",
      optional: true,
    },
    shouldSkipRules: {
      type: "boolean",
      label: "Should Skip Rules",
      description: "Whether or not the rules should apply to this message. (Default: true)",
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      inboxId,
      handle,
      name,
      authorId,
      subject,
      body,
      bodyFormat,
      externalId,
      createdAt,
      type,
      assigneeId,
      threadRef,
      isArchive,
      isInbound,
      shouldSkipRules,
    } = this;

    const to = utils.parse(this.to);
    const cc = utils.parse(this.cc);
    const bcc = utils.parse(this.bcc);
    const tags = utils.parse(this.tags);

    const data = {
      sender: {
        author_id: authorId,
        name,
        handle,
      },
      to,
      cc,
      bcc,
      subject,
      body,
      body_format: bodyFormat,
      external_id: externalId,
      created_at: createdAt,
      type,
      assignee_id: assigneeId,
      tags,
      metadata: {
        thread_ref: threadRef,
        is_inbound: isInbound,
        is_archived: isArchive,
        should_skip_rules: shouldSkipRules,
      },
    };

    const response =
      await this.frontApp.importMessage({
        inboxId,
        data,
      });

    const { message_uid: messageId } = response;

    $.export("$summary", `Successfully imported message with ID ${messageId}`);

    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.

LabelPropTypeDescription
FrontfrontAppappThis component uses the Front app.
Inbox IDinboxIdstringSelect a value from the drop down menu.
Handlehandlestring

Handle used to reach the contact. Can be an email address, a twitter, handle, a phone number, custom handle ...

Namenamestring

Name of the contact.

Author IDauthorIdstringSelect a value from the drop down menu.
Totostring[]

List of recipient handles who received the message.

CCccstring[]

List of recipient handles who received a copy of the message.

BCCbccstring[]

List of the recipeient handles who received a blind copy of the message.

Subjectsubjectstring

Subject of the message.

Bodybodystring

Body of the message.

Body FormatbodyFormatstringSelect a value from the drop down menu:htmlmarkdown
External IDexternalIdstring

External identifier of the message. Front won't import two messages with the same external ID.

Created AtcreatedAtinteger

Date at which the message has been sent or received. A timestamp is expected as in 1655507769

TypetypestringSelect a value from the drop down menu:emailsmsintercomcustom
Assignee IDassigneeIdstringSelect a value from the drop down menu.
Tag IDstagsstring[]Select a value from the drop down menu.
Thread RefthreadRefstringSelect a value from the drop down menu.
Is InboundisInboundboolean

Whether or not the message is received (inbound) or sent (outbound) by you

Is ArchiveisArchiveboolean

Whether or not the message should be directly archived once imported. (Default: true)

Should Skip RulesshouldSkipRulesboolean

Whether or not the rules should apply to this message. (Default: true)

Action Authentication

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

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

About Front

Customer communication platform

More Ways to Connect Front + GitHub

Send new message with Front API on New Commit from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Gist from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Mention from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Notification from GitHub API
GitHub + Front
 
Try it
Send new message with Front API on New Organization from GitHub API
GitHub + Front
 
Try it
New Branch (Instant) from the GitHub API

Emit new events when a new branch is created

 
Try it
New Card in Column (Classic Projects) from the GitHub API

Emit new event when a (classic) project card is created or moved to a specific column. For Projects V2 use New Issue with Status trigger. More information here

 
Try it
New Collaborator (Instant) from the GitHub API

Emit new events when collaborators are added to a repo

 
Try it
New Commit (Instant) from the GitHub API

Emit new events on new commits to a repo or branch

 
Try it
New Commit Comment (Instant) from the GitHub API

Emit new events on new commit comments

 
Try it
Create Issue with the GitHub API

Create a new issue in a Gihub repo. See docs here

 
Try it
Search Issues and Pull Requests with the GitHub API

Find issues and pull requests by state and keyword. See docs here

 
Try it
Create Issue Comment with the GitHub API

Create a new comment in a issue. See docs here

 
Try it
Create or update file contents with the GitHub API

Create or update a file in a repository. This will replace an existing file. See docs here

 
Try it
Get Issue Assignees with the GitHub API

Get assignees for an issue in a Gihub repo. See docs here

 
Try it