---
title: How to set up webhooks on Race Roster
description: Race Roster Knowledge Base
---
[Skip to content](https://help.raceroster.com/en-us/knowledge-base/how-to-set-up-webhooks-on-race-roster#main-content)
[Submit a knowledge article idea](https://help.raceroster.com/en-us/knowledge-base/kb-tickets/new?hsLang=en-us)
Open main navigation
Close main navigation
- [Submit a knowledge article idea](https://help.raceroster.com/en-us/knowledge-base/kb-tickets/new)
How can we help you?
- There are no suggestions because the search field is empty.
1. [Race Roster Knowledge Base](https://help.raceroster.com/en-us/knowledge-base?hsLang=en-us)
2. [Event Organizers and Race Directors](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us)
3. [Reports](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#reports)
February 23, 2026
# How to set up webhooks on Race Roster
A webhook is a one-time data send for each instance when a pre-set trigger has been met. Webhooks are often used to send specific information to an external partner at the time of registration. For example, you may automate sending participant information to an external vendor for one of your event's products. This way, the vendor can have a record of each product transaction, along with the participant's information if any action is needed from the vendor.
1\. From your event dashboard, you can enable **Webhook request settings** from the settings overview tab from the lefthand side menu by clicking on the Webhook request settings card available under **Add-ons**.
2\. Once enabled, this setting will permanently be available under your **Add-ons** tab from the lefthand side menu, so that you may access from there.
3\. Click the "**+ Create webhook**" button to begin configuring the parameters and settings of your first webhook.
4\. Input the following information to configure your webhook:
- **Webhook name**
- The webhook name is for your purposes only
- It is only displayed within the webhook settings as a way to distinguish between multiple webhooks
- **Selecting webhook status**
- Active or inactive
- **Endpoint URL**
- The endpoint URL for the webhook from your system
- This It can make either a GET or POST request to your desired URL
- **Request method**
- POST = Sending and updating new data
- GET = Retrieving data
- **API Key**
- this is generated by default and you may leave it as is, but you may also enter a custom API key if needed
5\. Select **data tags** for the webhook. Click on the dropdown menu under the **Add new tag** headline, locate a piece of data you want to include in the webhook, and then click the **"Add tag"** button. Repeat this process until you have specified all the tags you want. The selected tags will be the data fields that are pulled from the participant's transaction and sent to the endpoint URL provided by the third party. Tags can consist of:
- personal information
- product selections
- answers to registration questions
6\. Set the **triggers** for the webhook. The selected triggers are what will initiate the webhook once the criteria has been met by the participant during registration. Set your triggers so that a new webhook will be sent once the desired action has been met.
7\. Click "**Save & exit**" on the bottom right to apply all edits and finish creating the webhook.
From here on, as new registrations come in, those which fulfill the triggers will activate the webhook and send data to the endpoint URL.
### **Validating webhooks**
To validate a webhook that came from Race Roster and belongs to your event, you may decode the base64-encoded string within the authorization header to check that it matches your webhook API key.
1. Receive a POST request sent from Race Roster
2. Read the authorization header from the POST request
3. Decode the Base64 value after "Basic "
For example, in:
```
Basic QVBJX0tFWQ==
```
you would decode the Base64 value of
```
QVBJX0tFWQ==
```
4. Confirm that the decoded value matches your API key
Basic QVBJX0tFWQ==QVBJX0tFWQ==
**Notes:**
- webhooks can be sent as JSON files which are lightweight, text-based file formats that can be opened and read through any text editor.
- webhooks will still send if the event is in draft or demo status
- **webhooks will *not* send from manually adding participants** to an event
- [Event Organizers and Race Directors](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#main-content)
- [Participant Management](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#participant-management)
- [Financials](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#financials)
- [Marketing & Promotions](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#marketing-promotions)
- [Email Campaigns, MailChimp Integration](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#email-campaigns-mailchimp-integration)
- [Products](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#products)
- [Team Management and Settings](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#team-management-and-settings)
- [Onsite App](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#onsite-app)
- [Registration Questions](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#registration-questions)
- [Fundraising Settings and Receipts](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#fundraising-settings-and-receipts)
- [Promo Codes, Discounts, and Gifting Codes](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#promo-codes-discounts-and-gifting-codes)
- [Virtual](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#virtual)
- [Results](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#results)
- [Access codes](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#access-codes)
- [Director Access and Settings](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#director-access-and-settings)
- [Pricing](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#pricing)
- [Event Page Settings](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#event-page-settings)
- [Your Dashboard](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#your-dashboard)
- [Sub-events](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#sub-events)
- [Other FAQs](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#other-faqs)
- [Volunteers](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#volunteers)
- [Create, Edit or Take Your Event Live](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#create-edit-or-take-your-event-live)
- [Waivers](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#waivers)
- [Reports](https://help.raceroster.com/en-us/knowledge-base/event-organizers-and-race-directors?hsLang=en-us#reports)
- [Participants and Fundraisers](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#main-content)
- [Participant FAQs](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#participant-faqs)
- [Fundraising](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#fundraising)
- [Gift Registrations](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#gift-registrations)
- [Sign In and Manage Registration](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#sign-in-and-manage-registration)
- [Transfer Registration](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#transfer-registration)
- [Access Codes](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#access-codes)
- [Teams](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#teams)
- [Security & Compliance](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#security-compliance)
- [Promo Codes](https://help.raceroster.com/en-us/knowledge-base/participants-and-fundraisers?hsLang=en-us#promo-codes)
- [Race Roster CRM](https://help.raceroster.com/en-us/knowledge-base/race-roster-crm?hsLang=en-us#main-content)
- [Organizations](https://help.raceroster.com/en-us/knowledge-base/race-roster-crm?hsLang=en-us#organizations)
- [Contact Management and Validation Lists](https://help.raceroster.com/en-us/knowledge-base/race-roster-crm?hsLang=en-us#contact-management-and-validation-lists)
- [Reporting](https://help.raceroster.com/en-us/knowledge-base/race-roster-crm?hsLang=en-us#reporting)
- [Events and Event Groups](https://help.raceroster.com/en-us/knowledge-base/race-roster-crm?hsLang=en-us#events-and-event-groups)
- [Campaigns and Marketing](https://help.raceroster.com/en-us/knowledge-base/race-roster-crm?hsLang=en-us#campaigns-and-marketing)
- [Non-profit Organizations](https://help.raceroster.com/en-us/knowledge-base/race-roster-crm?hsLang=en-us#non-profit-organizations)
- [Fundraising Coordinators](https://help.raceroster.com/en-us/knowledge-base/fundraising-coordinators?hsLang=en-us#main-content)
- [Resources](https://help.raceroster.com/en-us/knowledge-base/fundraising-coordinators?hsLang=en-us#resources)
- [Participant and Team Fundraising](https://help.raceroster.com/en-us/knowledge-base/fundraising-coordinators?hsLang=en-us#participant-and-team-fundraising)
- [Reporting](https://help.raceroster.com/en-us/knowledge-base/fundraising-coordinators?hsLang=en-us#reporting)
- [Timers](https://help.raceroster.com/en-us/knowledge-base/timers?hsLang=en-us#main-content)
- [Account settings](https://help.raceroster.com/en-us/knowledge-base/timers?hsLang=en-us#account-settings)
- [Results](https://help.raceroster.com/en-us/knowledge-base/timers?hsLang=en-us#results)
- [Timing Tools](https://help.raceroster.com/en-us/knowledge-base/timers?hsLang=en-us#timing-tools)
- [Bib Assignment](https://help.raceroster.com/en-us/knowledge-base/timers?hsLang=en-us#bib-assignment)
- [Participant Data and Reports](https://help.raceroster.com/en-us/knowledge-base/timers?hsLang=en-us#participant-data-and-reports)
- [The ASICS Runkeeper™ app](https://help.raceroster.com/en-us/knowledge-base/the-asics-runkeeper-app?hsLang=en-us#main-content)
- [The ASICS Runkeeper™ app](https://help.raceroster.com/en-us/knowledge-base/the-asics-runkeeper-app?hsLang=en-us#the-asics-runkeeper-app)
[](https://raceroster.com)
Copyright © 2026, Race Roster