List Bitlinks by group with Bitly API on New Email Received from Gmail (Developer App) API

Pipedream makes it easy to connect APIs for Bitly, Gmail (Developer App) and 2,200+ other apps remarkably fast.

Trigger workflow on

New Email Received from the Gmail (Developer App) API

Next, do this

List Bitlinks by group with the Bitly 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 Gmail (Developer App) trigger and Bitly 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 Received trigger
1. Configure timer
2. Connect your Gmail (Developer App) account
3. Optional- Select a Label
Configure the List Bitlinks by group action
1. Connect your Bitly account
2. Configure Group GUID
3. Optional- Configure Size
4. Optional- Configure Page
5. Optional- Configure Keyword
6. Optional- Configure Query
7. Optional- Configure Created before
8. Optional- Configure Created after
9. Optional- Configure Modified after
10. Optional- Select a Archived
11. Optional- Select a Deeplinks
12. Optional- Select a Domain deeplinks
13. Optional- Configure Campaign guid
14. Optional- Configure Channel guid
15. Optional- Select a Custom bitlink
16. Optional- Configure Tags
17. Optional- Configure Launchpad IDs
18. Optional- Configure Encoding Login
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 Received on Gmail (Developer App)

Description:Emit new event when a new email is received.

Version:0.0.13

Key:gmail_custom_oauth-new-email-received

View on GitHub

Gmail (Developer App) Overview#

With the Gmail (Developer App) API on Pipedream, you can automate a variety of email-related tasks, directly manipulating your Gmail account to streamline workflows. From sending emails programmatically to parsing new inbound messages for data extraction, the API allows for deep interaction with your Gmail inbox. Use cases include automating follow-ups, organizing your inbox with filters and labels, and synchronizing important email events with other services to act upon new information instantly.

Trigger Code#

import base from "../../../gmail/sources/new-email-received/new-email-received.mjs";
import overrideApp from "../../common/override-app.mjs";

overrideApp(base);

export default {
  ...base,
  key: "gmail_custom_oauth-new-email-received",
  name: "New Email Received",
  description: "Emit new event when a new email is received.",
  type: "source",
  version: "0.0.13",
  dedupe: "unique",
};

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
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Gmail (Developer App)	`gmail`	`app`	This component uses the Gmail (Developer App) app.
Label	`label`	`string`	Select a value from the drop down menu.

Trigger Authentication#

Gmail (Developer App) uses OAuth authentication. When you connect your Gmail (Developer App) account, Pipedream will open a popup window where you can sign into Gmail (Developer App) 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 (Developer App) API.

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

do not use

About Gmail (Developer App)#

Private and secure email by Google at no cost, for business and consumer accounts. Use this app to connect your own developer account credentials.

Action#

List Bitlinks by group on Bitly

Description:Retrieves all Bitlinks for a given group. [See the docs here](https://dev.bitly.com/api-reference#getBitlinksByGroup)

Version:0.0.1

Key:bitly-list-bitlink-by-group

View on GitHub

Bitly Overview#

The Bitly API enables you to programmatically shorten URLs, track click rates, and manage link performance metrics. By integrating Bitly with Pipedream, you can automate various tasks around link management and amalgamate Bitly’s capabilities with other services, thereby streamlining digital marketing efforts, enhancing social media strategies, and monitoring engagement through data-driven insights.

Action Code#

import { removeNullEntries } from "../../common/utils.mjs";
import bitly from "../../bitly.app.mjs";

export default {
  key: "bitly-list-bitlink-by-group",
  name: "List Bitlinks by group",
  description:
    "Retrieves all Bitlinks for a given group. [See the docs here](https://dev.bitly.com/api-reference#getBitlinksByGroup)",
  version: "0.0.1",
  type: "action",
  props: {
    bitly,
    groupGuid: {
      type: "string",
      label: "Group GUID",
      description: "A GUID for a Bitly group",
    },
    size: {
      type: "string",
      label: "Size",
      description: "The quantity of items to be be returned",
      optional: true,
      default: "10",
    },
    page: {
      type: "string",
      label: "Page",
      description: "Integer specifying the numbered result at which to start",
      optional: true,
      default: "1",
    },
    keyword: {
      type: "string",
      label: "Keyword",
      description: "Custom keyword to filter on history entries",
      optional: true,
    },
    query: {
      type: "string",
      label: "Query",
      description: "The value that you would like to search",
      optional: true,
    },
    createdBefore: {
      type: "string",
      label: "Created before",
      description: "Timestamp as an integer unix epoch",
      optional: true,
    },
    createdAfter: {
      type: "string",
      label: "Created after",
      description: "Timestamp as an integer unix epoch",
      optional: true,
    },
    modifiedAfter: {
      type: "string",
      label: "Modified after",
      description: "Timestamp as an integer unix epoch",
      optional: true,
    },
    archived: {
      type: "string",
      label: "Archived",
      description: "Whether or not to include archived bitlinks",
      default: "off",
      optional: true,
      options: [
        "on",
        "off",
        "both",
      ],
    },
    deeplinks: {
      type: "string",
      label: "Deeplinks",
      description: "Filter to only Bitlinks that contain deeplinks",
      default: "both",
      optional: true,
      options: [
        "on",
        "off",
        "both",
      ],
    },
    domainDeeplinks: {
      type: "string",
      label: "Domain deeplinks",
      description:
        "Filter to only Bitlinks that contain deeplinks configured with a custom domain",
      default: "both",
      optional: true,
      options: [
        "on",
        "off",
        "both",
      ],
    },
    campaignGuid: {
      type: "string",
      label: "Campaign guid",
      description:
        "Filter to return only links for the given campaign GUID, can be provided",
      optional: true,
    },
    channelGuid: {
      type: "string",
      label: "Channel guid",
      description:
        "Filter to return only links for the given channel GUID, can be provided, overrides all other parameters",
      optional: true,
    },
    customBitlink: {
      type: "string",
      label: "Custom bitlink",
      description: "Filter to only Bitlinks that contain deeplinks",
      default: "both",
      optional: true,
      options: [
        "on",
        "off",
        "both",
      ],
    },
    tags: {
      type: "string[]",
      label: "Tags",
      description: "Filter by given tags",
      optional: true,
    },
    launchpadIds: {
      type: "string[]",
      label: "Launchpad IDs",
      description: "This is an array of strings",
      optional: true,
    },
    encodingLogin: {
      type: "string[]",
      label: "Encoding Login",
      description:
        "Filter by the login of the authenticated user that created the Bitlink. This is an array of strings",
      optional: true,
    },
  },
  async run({ $ }) {
    let next;
    let data = [];
    let result = null;
    let params = removeNullEntries({
      size: this.size,
      page: this.page,
      keyword: this.keyword,
      query: this.query,
      created_before: this.createdBefore,
      created_after: this.createdAfter,
      modified_after: this.modifiedAfter,
      archived: this.archived,
      deeplinks: this.deeplinks,
      domain_deeplinks: this.domainDeeplinks,
      campaign_guid: this.campaignGuid,
      channel_guid: this.channelGuid,
      custom_bitlink: this.customBitlink,
      tags: this.tags,
      launchpad_ids: this.launchpadIds,
      encoding_login: this.encodingLogin,
    });
    do {
      params.page++;
      result = await this.bitly.listBitlinkByGroup(this.groupGuid, params);
      next = result.pagination?.next;
      result?.links?.length && (data = [
        ...data,
        ...result.links,
      ]);
    } while (next);
    $.export("$summary", `Successfully listed ${data.length} bitlinks.`);
    return data;
  },
};

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
Bitly	`bitly`	`app`	This component uses the Bitly app.
Group GUID	`groupGuid`	`string`	A GUID for a Bitly group
Size	`size`	`string`	The quantity of items to be be returned
Page	`page`	`string`	Integer specifying the numbered result at which to start
Keyword	`keyword`	`string`	Custom keyword to filter on history entries
Query	`query`	`string`	The value that you would like to search
Created before	`createdBefore`	`string`	Timestamp as an integer unix epoch
Created after	`createdAfter`	`string`	Timestamp as an integer unix epoch
Modified after	`modifiedAfter`	`string`	Timestamp as an integer unix epoch
Archived	`archived`	`string`	Select a value from the drop down menu:`onoffboth`
Deeplinks	`deeplinks`	`string`	Select a value from the drop down menu:`onoffboth`
Domain deeplinks	`domainDeeplinks`	`string`	Select a value from the drop down menu:`onoffboth`
Campaign guid	`campaignGuid`	`string`	Filter to return only links for the given campaign GUID, can be provided
Channel guid	`channelGuid`	`string`	Filter to return only links for the given channel GUID, can be provided, overrides all other parameters
Custom bitlink	`customBitlink`	`string`	Select a value from the drop down menu:`onoffboth`
Tags	`tags`	`string[]`	Filter by given tags
Launchpad IDs	`launchpadIds`	`string[]`	This is an array of strings
Encoding Login	`encodingLogin`	`string[]`	Filter by the login of the authenticated user that created the Bitlink. This is an array of strings

Action Authentication#

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

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

About Bitly#

URL shortener

More Ways to Connect Bitly + Gmail (Developer App)#

Other Popular Integrations#

Shorten a Link with Bitly API on New Email Received from Gmail (Developer App) API

Gmail (Developer App) + Bitly

List Bitlinks by group with Bitly API on New Email Received from Gmail (Developer App) API

Pipedream makes it easy to connect APIs for Bitly, Gmail (Developer App) and 2,200+ other apps remarkably fast.

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

Developers ♥ Pipedream

1-24of2,200+apps by most popular

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