← Twilio SendGrid + Eventbrite integrations

Create Event with Eventbrite APIon New Contact (Instant) from Twilio SendGrid API

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

Trigger workflow on
New Contact (Instant) from the Twilio SendGrid API
Next, do this
Create Event with the Eventbrite API
No credit card required
Trusted by 200,000+ developers from startups to Fortune 500 companies:
Trusted by 200,000+ developers from startups to Fortune 500 companies

Developers Pipedream

Getting Started

This integration creates a workflow with a Twilio SendGrid trigger and Eventbrite 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 Contact (Instant) trigger
    1. Connect your Twilio SendGrid account
    2. Configure timer
  3. Configure the Create Event action
    1. Connect your Eventbrite account
    2. Select a Organization
    3. Configure Name
    4. Optional- Configure Summary
    5. Select a Timezone
    6. Configure Start Time
    7. Configure End Time
    8. Optional- Configure Hide Start Date
    9. Optional- Configure Hide End Date
    10. Configure Currency
    11. Optional- Configure Online Event
    12. Optional- Configure Organizer ID
    13. Optional- Configure Logo ID
    14. Optional- Configure Venue ID
    15. Optional- Configure Format ID
    16. Optional- Configure Category ID
    17. Optional- Configure Subcategory ID
    18. Configure Listed
    19. Optional- Configure Shareable
    20. Optional- Configure Invite Only
    21. Optional- Configure Show Remaining
    22. Optional- Configure Password
    23. Optional- Configure Capacity
    24. Optional- Configure Is Reserved Seating
    25. Optional- Configure Is Series
    26. Optional- Configure Show Pick A Seat
    27. Optional- Configure Show Seatmap Thumbnail
    28. Optional- Configure Show Colors In Seatmap Thumbnail
    29. Optional- Configure Source
    30. Select a Locale
  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 an event when a new contact is created
Version:0.0.2
Key:sendgrid-new-contact

Trigger Code

const orderBy = require("lodash/orderBy");

const common = require("../common/timer-based");

module.exports = {
  ...common,
  key: "sendgrid-new-contact",
  name: "New Contact (Instant)",
  description: "Emit an event when a new contact is created",
  version: "0.0.2",
  dedupe: "unique",
  hooks: {
    async activate() {
      const currentTimestamp = Date.now();
      const state = {
        processedItems: [],
        lowerTimestamp: currentTimestamp,
        upperTimestamp: currentTimestamp,
      };
      this.db.set("state", state);
    },
  },
  methods: {
    ...common.methods,
    _maxDelayTime() {
      // There is no report from SendGrid as to how much time it takes
      // for a contact to be created and appear in search results, so
      // we're using a rough estimate of 30 minutes here.
      return 30 * 60 * 1000;  // 30 minutes, in milliseconds
    },
    _addDelayOffset(timestamp) {
      return timestamp - this._maxDelayTime();
    },
    _cleanupOldProcessedItems(processedItems, currentTimestamp) {
      return processedItems
        .map((item) => ({
          // We just need to keep track of the record ID and
          // its creation date.
          id: item.id,
          created_at: item.created_at,
        }))
        .filter((item) => {
          const { created_at: createdAt } = item;
          const createdAtTimestamp = Date.parse(createdAt);
          const cutoffTimestamp = this._addDelayOffset(currentTimestamp);
          return createdAtTimestamp > cutoffTimestamp;
        });
    },
    _makeSearchQuery(processedItems, lowerTimestamp, upperTimestamp) {
      const idList = processedItems
        .map((item) => item.id)
        .map((id) => `'${id}'`)
        .join(", ")
      || "''";
      const startTimestamp = this._addDelayOffset(lowerTimestamp);
      const startDate = this.toISOString(startTimestamp);
      const endDate = this.toISOString(upperTimestamp);
      return `
        contact_id NOT IN (${idList}) AND
        created_at BETWEEN
          TIMESTAMP '${startDate}' AND
          TIMESTAMP '${endDate}'
      `;
    },
    generateMeta(data) {
      const {
        item,
        eventTimestamp: ts,
      } = data;
      const {
        id,
        email,
      } = item;
      const slugifiedEmail = this.slugifyEmail(email);
      const summary = `New contact: ${slugifiedEmail}`;
      return {
        id,
        summary,
        ts,
      };
    },
    async processEvent(event) {
      // Transform the timer timestamp to milliseconds
      // to be consistent with how Javascript handles timestamps.
      const eventTimestamp = event.timestamp * 1000;

      // Retrieve the current state of the component.
      const {
        processedItems,
        lowerTimestamp,
        upperTimestamp,
      } = this.db.get("state");

      // Search for contacts within a specific timeframe, excluding
      // items that have already been processed.
      const query = this._makeSearchQuery(processedItems, lowerTimestamp, upperTimestamp);
      const {
        result: items,
        contact_count: contactCount,
      } = await this.sendgrid.searchContacts(query);

      // If no contacts have been retrieved via the API,
      // move the time window forward to possibly capture newer contacts.
      if (contactCount === 0) {
        const newState = {
          processedItems: this._cleanupOldProcessedItems(processedItems, lowerTimestamp),
          lowerTimestamp: upperTimestamp,
          upperTimestamp: eventTimestamp,
        };
        this.db.set("state", newState);
        return;
      }

      // We process the searched records from oldest to newest.
      const itemsToProcess = orderBy(items, "created_at");
      itemsToProcess
        .forEach((item) => {
          const meta = this.generateMeta({
            item,
            eventTimestamp,
          });
          this.$emit(item, meta);
        });

      // Use the timestamp of the last processed record as a lower bound for
      // following searches. This bound will be subjected to an offset so in
      // case older records appear in future search results, but have not
      // appeared until now, can be processed. We only adjust it if it means
      // moving forward, not backwards. Otherwise, we might start retrieving
      // older and older records indefinitely (and we're all about *new*
      // records!)
      const newLowerTimestamp = Math.max(
        lowerTimestamp,
        Date.parse(itemsToProcess[0].created_at),
      );

      // If the total contact count is less than 100, it means that during the
      // next iteration the search results count will most likely be less than
      // 50. In that case, if we extend the upper bound of the search time range
      // we might be able to retrieve more records.
      const newUpperTimestamp = contactCount < 100
        ? eventTimestamp
        : upperTimestamp;

      // The list of processed items can grow indefinitely.
      // Since we don't want to keep track of every processed record
      // ever, we need to clean up this list, removing any records
      // that are no longer relevant.
      const newProcessedItems = this._cleanupOldProcessedItems(
        [
          ...processedItems,
          ...itemsToProcess,
        ],
        newLowerTimestamp,
      );

      // Update the state of the component to reflect the computations
      // made above.
      const newState = {
        processedItems: newProcessedItems,
        lowerTimestamp: newLowerTimestamp,
        upperTimestamp: newUpperTimestamp,
      };
      this.db.set("state", newState);
    },
  },
};

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
N/Adb$.service.dbThis component uses $.service.db to maintain state between component invocations.
Twilio SendGridsendgridappThis component uses the Twilio SendGrid app.
timer$.interface.timer

Trigger 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.

When you create an API key, you assign scopes, or specific permissions, to the key. Sendgrid requires separate API keys for making billing-related API calls. To create an API key, navigate to Settings on the left navigation bar, and then select API keys.

More info: Creating an API key | API key permissions

About Twilio SendGrid

Delivering your transactional and marketing emails through the world's largest cloud-based email delivery platform. Send with confidence.

Action

Description:Create a new Eventbrite event
Version:0.0.1
Key:eventbrite-create-event

Action Code

const eventbrite = require("../../eventbrite.app");
const locales = require("../locales.js");

module.exports = {
  key: "eventbrite-create-event",
  name: "Create Event",
  description: "Create a new Eventbrite event",
  version: "0.0.1",
  type: "action",
  props: {
    eventbrite,
    organization: {
      propDefinition: [
        eventbrite,
        "organization",
      ],
    },
    name: {
      type: "string",
      label: "Name",
      description: "Event name. Value cannot be empty nor whitespace",
    },
    summary: {
      type: "string",
      label: "Summary",
      description:
        "Event summary. This is a plaintext field and will have any supplied HTML removed from it. Maximum of 140 characters",
      optional: true,
    },
    timezone: {
      propDefinition: [
        eventbrite,
        "timezone",
      ],
    },
    startTime: {
      type: "string",
      label: "Start Time",
      description:
        "The event start time relative to UTC. (Ex. 2018-05-12T02:00:00Z).",
    },
    endTime: {
      type: "string",
      label: "End Time",
      description:
        "The event end time relative to UTC. (Ex. 2018-05-12T02:00:00Z)",
    },
    hideStartDate: {
      type: "boolean",
      label: "Hide Start Date",
      description: "Whether the start date should be hidden. Defaults to false if left blank.",
      optional: true,
    },
    hideEndDate: {
      type: "boolean",
      label: "Hide End Date",
      description: "Whether the end date should be hidden. Defaults to false if left blank.",
      optional: true,
    },
    currency: {
      type: "string",
      label: "Currency",
      description: "The ISO 4217 currency code for this event",
      default: "USD",
    },
    onlineEvent: {
      type: "boolean",
      label: "Online Event",
      description: "If this event doesn't have a venue and is only held online. Defaults to false if left blank.",
      optional: true,
    },
    organizerId: {
      type: "string",
      label: "Organizer ID",
      description: "ID of the event organizer",
      optional: true,
    },
    logoId: {
      type: "string",
      label: "Logo ID",
      description: "Image ID of the event logo",
      optional: true,
    },
    venueId: {
      type: "string",
      label: "Venue ID",
      description: "Event venue ID",
      optional: true,
    },
    formatId: {
      type: "string",
      label: "Format ID",
      description: "Event format",
      optional: true,
    },
    categoryId: {
      type: "string",
      label: "Category ID",
      description: "Event category",
      optional: true,
    },
    subcategoryId: {
      type: "string",
      label: "Subcategory ID",
      description: "Event subcategory (US only)",
      optional: true,
    },
    listed: {
      type: "boolean",
      label: "Listed",
      description: "Is this event publicly searchable on Eventbrite? Defaults to true.",
      default: true,
    },
    shareable: {
      type: "boolean",
      label: "Shareable",
      description: "Can this event show social sharing buttons? Defaults to false if left blank.",
      optional: true,
    },
    inviteOnly: {
      type: "boolean",
      label: "Invite Only",
      description: "Can only people with invites see the event page?. Defaults to false if left blank.",
      optional: true,
    },
    showRemaining: {
      type: "boolean",
      label: "Show Remaining",
      description:
        "If the remaining number of tickets is publicly visible on the event page. Defaults to false if left blank.",
      optional: true,
    },
    password: {
      type: "string",
      label: "Password",
      description: "Password needed to see the event in unlisted mode",
      optional: true,
    },
    capacity: {
      type: "integer",
      label: "Capacity",
      description: "Set specific capacity (if omitted, sums ticket capacities)",
      optional: true,
    },
    isReservedSeating: {
      type: "boolean",
      label: "Is Reserved Seating",
      description: "If the event is reserved seating. Defaults to false if left blank.",
      optional: true,
    },
    isSeries: {
      type: "boolean",
      label: "Is Series",
      description:
        "If the event is part of a series. Specifying this attribute as True during event creation will always designate the event as a series parent, never as a series occurrence. Series occurrences must be created through the schedules API and cannot be created using the events API. Defaults to false if left blank.",
      optional: true,
    },
    showPickASeat: {
      type: "boolean",
      label: "Show Pick A Seat",
      description:
        "For reserved seating event, if attendees can pick their seats. Defaults to false if left blank.",
      optional: true,
    },
    showSeatmapThumbnail: {
      type: "boolean",
      label: "Show Seatmap Thumbnail",
      description:
        "For reserved seating event, if venue map thumbnail visible on the event page. Defaults to false if left blank.",
      optional: true,
    },
    showColorsInSeatmapThumbnail: {
      type: "boolean",
      label: "Show Colors In Seatmap Thumbnail",
      description:
        "For reserved seating event, if venue map thumbnail should have colors on the event page. Defaults to false if left blank.",
      optional: true,
    },
    source: {
      type: "string",
      label: "Source",
      description: "Source of the event (defaults to API)",
      optional: true,
    },
    locale: {
      type: "string",
      label: "Locale",
      description: "Indicates event language on Event's listing page. Language options from Eventbrite documentation: https://www.eventbrite.com/platform/api#/reference/event/retrieve/create-an-event",
      options: locales,
      default: "en_US",
    },
  },
  async run() {
    /* convert start and end time to UTC in case time was entered with timezone offset */
    const startTime = (new Date(this.startTime)).toISOString()
      .split(".")[0] + "Z";
    const endTime = (new Date(this.endTime)).toISOString()
      .split(".")[0] + "Z";

    let data = {
      event: {
        name: {
          html: this.name,
        },
        summary: this.summary,
        start: {
          timezone: this.timezone,
          utc: startTime,
        },
        end: {
          timezone: this.timezone,
          utc: endTime,
        },
        hide_start_date: this.hideStartDate,
        hide_end_date: this.hideEndDate,
        currency: this.currency,
        online_event: this.onlineEvent,
        organizer_id: this.organizerId,
        logo_id: this.logoId,
        venue_id: this.venueId,
        format_id: this.formatId,
        category_id: this.categoryId,
        subcategory_id: this.subcategoryId,
        listed: this.listed,
        shareable: this.shareable,
        invite_only: this.inviteOnly,
        show_remaining: this.showRemaining,
        password: this.password,
        capacity: this.capacity,
        is_reserved_seating: this.isReservedSeating,
        is_series: this.isSeries,
        show_pick_a_seat: this.showPickASeat,
        show_seatmap_thumbnail: this.showSeatmapThumbnail,
        show_colors_in_seatmap_thumbnail: this.showColorsInSeatmapThumbnail,
        source: this.source,
        locale: this.locale,
      },
    };
    data = JSON.parse(JSON.stringify(data));
    return await this.eventbrite.createEvent(this.organization, 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.

LabelPropTypeDescription
EventbriteeventbriteappThis component uses the Eventbrite app.
OrganizationorganizationstringSelect a value from the drop down menu.
Namenamestring

Event name. Value cannot be empty nor whitespace

Summarysummarystring

Event summary. This is a plaintext field and will have any supplied HTML removed from it. Maximum of 140 characters

TimezonetimezonestringSelect a value from the drop down menu.
Start TimestartTimestring

The event start time relative to UTC. (Ex. 2018-05-12T02:00:00Z).

End TimeendTimestring

The event end time relative to UTC. (Ex. 2018-05-12T02:00:00Z)

Hide Start DatehideStartDateboolean

Whether the start date should be hidden. Defaults to false if left blank.

Hide End DatehideEndDateboolean

Whether the end date should be hidden. Defaults to false if left blank.

Currencycurrencystring

The ISO 4217 currency code for this event

Online EventonlineEventboolean

If this event doesn't have a venue and is only held online. Defaults to false if left blank.

Organizer IDorganizerIdstring

ID of the event organizer

Logo IDlogoIdstring

Image ID of the event logo

Venue IDvenueIdstring

Event venue ID

Format IDformatIdstring

Event format

Category IDcategoryIdstring

Event category

Subcategory IDsubcategoryIdstring

Event subcategory (US only)

Listedlistedboolean

Is this event publicly searchable on Eventbrite? Defaults to true.

Shareableshareableboolean

Can this event show social sharing buttons? Defaults to false if left blank.

Invite OnlyinviteOnlyboolean

Can only people with invites see the event page?. Defaults to false if left blank.

Show RemainingshowRemainingboolean

If the remaining number of tickets is publicly visible on the event page. Defaults to false if left blank.

Passwordpasswordstring

Password needed to see the event in unlisted mode

Capacitycapacityinteger

Set specific capacity (if omitted, sums ticket capacities)

Is Reserved SeatingisReservedSeatingboolean

If the event is reserved seating. Defaults to false if left blank.

Is SeriesisSeriesboolean

If the event is part of a series. Specifying this attribute as True during event creation will always designate the event as a series parent, never as a series occurrence. Series occurrences must be created through the schedules API and cannot be created using the events API. Defaults to false if left blank.

Show Pick A SeatshowPickASeatboolean

For reserved seating event, if attendees can pick their seats. Defaults to false if left blank.

Show Seatmap ThumbnailshowSeatmapThumbnailboolean

For reserved seating event, if venue map thumbnail visible on the event page. Defaults to false if left blank.

Show Colors In Seatmap ThumbnailshowColorsInSeatmapThumbnailboolean

For reserved seating event, if venue map thumbnail should have colors on the event page. Defaults to false if left blank.

Sourcesourcestring

Source of the event (defaults to API)

LocalelocalestringSelect a value from the drop down menu:{ "label": "German (Austria)", "value": "de_AT" }{ "label": "German (Switzerland)", "value": "de_CH" }{ "label": "German (Germany)", "value": "de_DE" }{ "label": "English (Australia)", "value": "en_AU" }{ "label": "English (Canada)", "value": "en_CA" }{ "label": "English (Denmark)", "value": "en_DK" }{ "label": "English (Finland)", "value": "en_FI" }{ "label": "English (United Kingdom)", "value": "en_GB" }{ "label": "English (Hong Kong)", "value": "en_KH" }{ "label": "English (Ireland)", "value": "en_IE" }{ "label": "English (India)", "value": "en_IN" }{ "label": "English (New Zealand)", "value": "en_NZ" }{ "label": "English (Sweden)", "value": "en_SE" }{ "label": "English (U.S.A.)", "value": "en_US" }{ "label": "Spanish (Argentina)", "value": "es_AR" }{ "label": "Spanish (Chile)", "value": "es_CL" }{ "label": "Spanish (Colombia)", "value": "es_CO" }{ "label": "Spanish (Spain)", "value": "es_ES" }{ "label": "French (Belgium)", "value": "fr_BE" }{ "label": "French (Canada)", "value": "fr_CA" }{ "label": "German (Switzerland)", "value": "fr_CH" }{ "label": "French (France)", "value": "fr_FR" }{ "label": "Hindi (India)", "value": "hi_IN" }{ "label": "Italian (Italy)", "value": "it_IT" }{ "label": "Dutch (Belgium)", "value": "nl_BE" }{ "label": "Dutch (Netherlands)", "value": "nl_NL" }{ "label": "Portuguese (Brazil)", "value": "pt_BR" }{ "label": "Portuguese (Portugal)", "value": "pt_PT" }

Action Authentication

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

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

More Ways to Connect Eventbrite + Twilio SendGrid

About Pipedream

Stop writing boilerplate code, struggling with authentication and managing infrastructure. Start connecting APIs with code-level control when you need it — and no code when you don't.

Into to Pipedream
Watch us build a workflow
Watch us build a workflow
4 min
Watch now ➜
"The past few weeks, I truly feel like the clichéd 10x engineer."
@heyellieday
Powerful features that scale
Manage concurrency and execution rate
Manage concurrency and execution rate

Queue up to 10,000 events per workfow and manage the concurrency and rate at which workflows are triggered.

Process large payloads up to 5 terabytes
Process large payloads up to 5 terabytes

Large file support enables you to trigger workflows with any data (e.g., large JSON files, images and videos) up to 5 terabytes.

Return custom responses to HTTP requests
Return custom responses to HTTP requests

Return any JSON-serializable response from an HTTP triggered workflow using $respond().

Use most npm packages
Use most npm packages

To use any npm package, just require() it -- there's no npm install or package.json required.

Maintain state between executions
Maintain state between executions

Use $checkpoint to save state in one workflow invocation and read it the next time your workflow runs.

Pass data between steps
Pass data between steps

Return data from any step to inspect it in a human-friendly way and reference the data in future steps via the steps object.