API for fan opt-ins
Updated over a week 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. 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 App ID you already use to call the Bandsintown API (or request one here)

  • 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 App ID you already use to call the Bandsintown API (or request one here)

  • 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 App ID you already use to call the Bandsintown API (or request one here)

  • 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 App ID you already use to call the Bandsintown API (or request one here)

  • 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?