Eventbrite integration

Breakroom makes it simple to sell or distribute tickets to your event through Eventbrite. Here's how to find the information you'll need to integrate your Breakroom and Eventbrite accounts.

Overview

By integrating your Breakroom account with Eventbrite, you can sell or distribute tickets to a virtual event and trust the backend logistics to us. Breakroom will automatically create a user account for anyone who purchases a ticket, using their ticket number as the password. If an account already exists under a user's email address, Breakroom will reactivate that account and reset the password to the ticketholder's current ticket number.

Pictured: An example event listing in Eventbrite.

In order to integrate Breakroom and Eventbrite, you will need an active Eventbrite account. As a first step, log in to your Eventbrite account and create the event you plan to host in Breakroom. You can then follow the instructions outlined below to integrate your event with Breakroom's systems.

Getting your Eventbrite API key

Once you've created your event on Eventbrite, you'll need to locate the API key associated with that event and enter it into the Breakroom Dashboard. To get started, navigate to your Eventbrite account settings page.

Highlighted: The location of the Account settings page on Eventbrite.

On the left side of the account settings page, you'll see a drop-down menu called Developer Links. Expand it, and click on the tab that says API Keys. Then click on the button that says Create API Key.

Highlighted: The API Keys tab, as well as the location of the "Create API Key" button.

Fill out the required information, and click the Create Key button.

Pictured: The Eventbrite API key request page.

Pictured: An example of how your API key may appear once generated, with the private token key highlighted.

Your API key should be generated automatically. Click the > arrow above the application name (in this case, Breakroom) to expand the key information menu. Highlight and copy the private token key.

Pictured: The Dashboard > Integration tab.

From here, you will need to enter the private token key into the Breakroom Dashboard. Follow the instructions below to do so.

1. Navigate to your Dashboard.

2. Click on the Integration tab.

3. Under the Select an integration to configure panel, click on the Eventbrite button.

4. Paste your Eventbrite private token API key into the field.

5. Click the Create payload URL button. Under the Payload URL panel, a special URL will be generated for you.

6. Highlight and copy the payload URL.

7. Return to the Eventbrite page to complete setup.

Setting up Webhook with payload URL

Pictured: The Webhooks tab on Eventbrite, with the Add Webhook button highlighted.

After you receive your payload URL, click on the Webhooks tab under Developer Links on your Eventbrite account settings page. Then click the button that says Add Webhook.

Pictured: The Eventbrite "Add Webhook" page.

From here, you will need to enter the payload URL into Eventbrite. Follow the instructions below to do so.

1. Paste the payload URL into the top field.

2. Using the drop-down Event menu, select either a specific event or All Events, if you want to link more than one event to a single ticket purchase.

3. Check the box beside order.placed.

4. Click the button that says Add Webhook.

Once all of these steps are completed, you are ready to go.

Onboarding Eventbrite ticketholders

When users purchase a virtual event ticket through Eventbrite, they will not receive a confirmation email from Breakroom. Therefore, we strongly encourage event organizers to use their Eventbrite listing, email, or other relevant tools to provide ticketholders with the information they will need to log in.

Key points to communicate to ticketholders include:

• Breakroom will automatically create a user account for anyone who purchases a virtual event ticket through Eventbrite. Their login will be the e-mail they provided to Eventbrite, and their password will be their ticket number.

• If a Breakroom account already exists under a user's email address, Breakroom will reactivate that account and reset the password to the ticketholder's current ticket number.

• Users will need to download the custom Breakroom desktop app or sign in through World Stream. Links to download the app or access your dedicated World Stream can be found on the Your Apps tab on the Dashboard.