Skip to main content
API for fan opt-ins
Updated over a month ago

If you use the Bandsintown API to promote tour dates on your website, you can add one or more of these specific calls to action (CTA) that will allow you to build your audience: each call to action encourages fans to subscribe to receive automated alerts & personalized direct messages, and provide their first-party data (name, location, email, phone).

There are four calls to action you can add:

1. Follow

Encourage your fans to follow you and receive updates on new shows, new music, and more. Best used with a header right above your tour dates.

2. Request a Show

Let your fans tell you where they’d like to see you play live and subscribe to receive updates on new shows and more. Ideal call to action below your tour dates or if you have no upcoming shows.

3. Set Reminder

Capture fan interest for a specific show and allow them to receive reminders and news about that show and more. Best used next to the TICKETS button of all your upcoming events.

4. Notify Me

Let your fans opt in to be notified about tickets for specific shows. The NOTIFY ME button replaces the TICKETS button when an event has no ticket link or when the on-sale date is in the future.

5. Waitlist

Boost fan engagement, manage sold-out events, and communicate with RSVPs using Waitlist.

Each of these buttons can be fully customized: button format, label, icon, color.

Learn how to add these CTAs to your website below.


Add a Follow button

Add this button above your tour dates to encourage your fans to follow you and receive updates on new shows and more. Use a short and clear call to action such as FOLLOW.

While not mandatory, we recommend that you add a header above the button to clarify its purpose and reassure fans as it’ll help drive more clicks. Suggested header: Get updates on new shows, new music, and more

The button itself can be a simple text link to which you apply the style that matches other links or buttons on your website. The link needs to point to your own custom Bandsintown “Follow” URL. See example:

https://bandsintown.com/artist-subscribe/2619661?app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=track

Copy the URL above and make sure to:

  • replace 2619661 with your own Bandsintown artist ID

  • replace {your_app_id} with the API Key you already use to call the Bandsintown API (how to get an API Key)

  • replace {your_affiliation_code} with the Affiliation Code you already use to call the Bandsintown API (or remove the affil_code parameter altogether if you don’t already have one)

To customize the colors and fonts of this form, see How to customize the Opt-in Form below.

Add a Request a Show button

Add this button below your tour dates or if you do not have upcoming shows so your fans can tell you where they’d like to see you play live and subscribe to receive updates on new shows and more. Use a short and clear call to action such as REQUEST A SHOW.

While not mandatory, we recommend that you add a header above the button to clarify its purpose and reassure fans as it’ll help drive more clicks. Suggested headers:

  • if you have upcoming shows: “No shows near you?

  • if you do not have upcoming shows: “No upcoming shows.

The button itself can be a simple text link to which you apply the style that matches other links or buttons on your website. The link needs to point to your own custom Bandsintown “Request a Show” URL. See example:

https://bandsintown.com/artist-subscribe/2619661?app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=play_my_city&play_my_city=true

Copy the URL above and make sure to:

  • replace 2619661 with your own Bandsintown artist ID

  • replace {your_app_id} with the API Key you already use to call the Bandsintown API (how to get an API Key)

  • replace {your_affiliation_code} with the Affiliation Code you already use to call the Bandsintown API (or remove the affil_code parameter altogether if you don’t already have one)

To customize the colors and fonts of this form, see How to customize the Opt-in Form below.

Add a RSVP button

Add this button to every event listed on your website, next to the TICKETS button, so your fans can RSVP to the show they’re interested in: they will receive reminders and news about this show, as well as updates on new shows in their area and more. Use a short and clear call to action such as RSVP or SET REMINDER.

The button itself can be a simple text link to which you apply the style that matches other links or buttons on your website. The link needs to point to your own custom Bandsintown event “RSVP” URL. See an example below:

https://bandsintown.com/artist-rsvp/2619661?event_id=102847014&app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=notify_me

Copy the URL above and make sure to:

  • replace 2619661 with your own Bandsintown artist ID

  • replace 102847014 with your own Bandsintown event ID (as pulled from the Bandsintown API)

  • replace {your_app_id} with the API Key you already use to call the Bandsintown API (how to get an API Key)

  • replace {your_affiliation_code} with the Affiliation Code you already use to call the Bandsintown API (or remove the affil_code parameter altogether if you don’t already have one)

To customize the colors and fonts of this form, see How to customize the Opt-in Form below.

Add a Notify Me button

Replace the TICKETS button with the NOTIFY ME button whenever your events have no ticket links or the on-sale date is in the future, so your fans can sign up and get notified about the show they’re interested in when tickets are available. They will receive reminders and news about this show, as well as updates on new shows in their area and more. Use a short and clear call to action such as NOTIFY ME.

The button itself can be a simple text link to which you apply the style that matches other links or buttons on your website. The link needs to point to your own custom Bandsintown event “NOTIFY ME” URL. See an example below:

https://bandsintown.com/artist-rsvp/2619661?event_id=102847014&app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=notify_me

Copy the URL above and make sure to:

  • replace 2619661 with your own Bandsintown artist ID

  • replace 102847014 with your own Bandsintown event ID (as pulled from the Bandsintown API)

  • replace {your_app_id} with the API Key you already use to call the Bandsintown API (how to get an API Key)

  • replace {your_affiliation_code} with the Affiliation Code you already use to call the Bandsintown API (or remove the affil_code parameter altogether if you don’t already have one)

To customize the colors and fonts of this form, see How to customize the Opt-in Form below.

Add a Waitlist button

How it works

When a show is sold out, the event’s RSVP button on the Widget and Smart Link will automatically change to a Waitlist button to encourage fans to sign up to be notified if more tickets become available. By clicking the Waitlist button, fans will be directed to an opt-in page where they can share their email addresses.

All fans who sign up will be added to the event’s RSVP list and will also become Followers, opting them in to automatically receive future event alerts about new dates added.

Artists and their teams can manually email fans if additional tickets are added.

Where to find it

If you use the Widget or Smart Link, the Waitlist button will appear automatically on any event you mark as sold out. If you use the Bandsintown API and would like to enable the Waitlist, all you need to do is update your RSVP link by adding &waitlist=true to the URL and setting the utm_campaign value to waitlist.

https://www.bandsintown.com/artist-rsvp/2619661?affil_code={your_affiliation_code}&app_id={your_app_id}&came_from=267&event_id=105238445&utm_campaign=waitlist&utm_medium=web&utm_source=api&waitlist=true

Copy the URL above and make sure to:

  • replace 2619661 with your own Bandsintown artist ID

  • replace 105238445 with your own Bandsintown event ID (as pulled from the Bandsintown API)

  • replace {your_app_id} with the API Key you already use to call the Bandsintown API (how to get an API Key)

  • replace {your_affiliation_code} with the Affiliation Code you already use to call the Bandsintown API (or remove the affil_code parameter altogether if you don’t already have one)

How to customize the Opt-in Form

Once you've created custom links for a call to action, you can modify the following parameters of the opt-in form to match your website.

- font (font names)
- text-color (hex or rgba color code)
- bg-color (hex or rgba color code)
- cta-text-color (hex or rgba color code)
- cta-bg-color (hex or rgba color code)
- cta-border-width (width in pixels)
- cta-border-radius (radius in pixels)
- cta-border-color (hex or rgba color code)

For example, this Follow link...

https://bandsintown.com/artist-subscribe/2619661?app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=track

...could have the following parameters added to the URL:

&font=Roboto&text-color=%23ffffff&bg-color=%23000000&cta-text-color=#f5bd41&cta-bg-color=%23000000&cta-border-width=2px&cta-border-radius=0px&cta-border-color=%23f5bd41

How to collect Phone Numbers in your Opt-in Form.

To collect phone numbers in your Opt-in form you will need to activate the “collect phone number” parameter in your Artist Settings, and manually add two new parameters in your Call To Action URL: &spn and &signature

To do this, please follow the next steps:

STEP 1

Verify in your API results if the parameter “artist_optin_show_phone_number“ is set to True.

If True, go to Step 3.

If False, go to Step 2.

STEP 2

If “artist_optin_show_phone_number“ is set to False. You must go to your Manager's Account and Turn ON the “Collect Phone Number“parameter in your Artist's Settings.

Wait at least 4 hours and then go to Step 1 to check the parameter in your API Results again.

STEP 3

Identify the key signature you need to add to your call to action URL.

  1. Open Toolbox in your Manager Account

  2. Click on the Smart Link tool

  3. Copy your Smart Link

  4. Open your smart link in your browser and click the Follow button

  5. Check in the URL for the parameter Signature and copy the entire key

STEP 4

Add the new parameters in your Call to Action URL:

&spn=1 and &signature=ZZded3ecb157113a9d4b4f8fc669cc4330ed4356d98299f9b8f7b58bc5d4a9e16b

For Example:

Follow:

https://bandsintown.com/artist-subscribe/2619661?app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=track&spn=1&signature=ZZded3ecb157113a9d4b4f8fc669cc4330ed4356d98299f9b8f7b58bc5d4a9e16b

Request a Show:

https://bandsintown.com/artist-subscribe/2619661?app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=play_my_city&play_my_city=true&spn=1&signature=ZZded3ecb157113a9d4b4f8fc669cc4330ed4356d98299f9b8f7b58bc5d4a9e16b

RSVP:

https://bandsintown.com/artist-rsvp/2619661?event_id=102847014&app_id={your_app_id}&affil_code={your_affiliation_code}&came_from=267&utm_source=public_api&utm_medium=api&utm_campaign=notify_me&spn=1&signature=ZZded3ecb157113a9d4b4f8fc669cc4330ed4356d98299f9b8f7b58bc5d4a9e16b

STEP 5

Verify your calls to action will trigger the Phone number collection.

Did this answer your question?