If you have not yet created an organization using our CRM, please reference our guide on how to create an organization on Race Roster.
To learn how to create a custom report within your organization, please follow the steps in this article.
Once you've created a report within an existing organization, you may send the contact data to a compatible third party platform by following the steps below:
1. Log in to your Race Roster account and land on your homepage. Use the kingdom switcher on the top left to select "CRM" and access the tool.
2. If needed, use the dropdown menu to find your existing, desired organization and navigate to its dashboard.
3. From your organization's dashboard, use the left menu to select Settings > Webhook requests.
4. Click "+ Create webhook". You will need to have at least one available report in order to create a webhook request, as reports contain the contacts that will feed into the webhook.
You will land on a page that looks like this:
5. Name the webhook. The name is for you and your organization's staff to distinguish between different requests. For example, you might create one webhook request containing female contacts who opted into receiving your organization's newsletter across all 2023 Race Roster events. Then, the following year you might want to do the exact same thing. In this case, you might call the first webhook "2023 female newsletter subscribers" and the second "2024 female newsletter subscribers".
6. Establish the Contact list(s). Select which report(s) to include as the source for this webhook request. Data from the contacts in these reports will be sent to the endpoint.
7. Select the webhook type.
- One time: Send the contact data once, based on the current version of the report(s) selected. If a report is itself is set to an automatic update, or if you manually update a report at a later date, those future updates will not send new contacts to or edit existing contact data at the endpoint. This option works well for reports on past Race Roster events.
- Automatically updated: Send the contact data to the endpoint on a recurring basis. This option works well for reports which pull contacts from current Race Roster events, especially if the reports are themselves being manually or automatically updated as the contact lists change. By setting the webhook request to "Automatically updated", it will update whenever a source report also updates.
8. Select the webhook endpoint.
- Mailchimp: Race Roster offers an integration with Mailchimp. Click "Connect Mailchimp". On the next screens, enter your Mailchimp account login credentials and authorize the Race Roster connection. Then, select a Mailchimp audience within your account to use as the contact data endpoint. Finally, review the summary and click "Send webhook".
- Custom (Make, Zapier, etc): If the webhook endpoint is a compatible third party provider, a manual process can make the connection possible. Enter the endpoint URL, select GET, POST or PUT for the request method and (optionally) enter the API key.
9. Once established, the Webhook requests page will allow you to view and manage existing webhooks. Please note that the data received at the endpoint will depend on the compatibility of fields.
Not every contact was sent from Race Roster to my Mailchimp audience. What happened?
If multiple contacts in a report contain the same email address, Race Roster will only send one of those contacts to Mailchimp. Furthermore, if a contact already exists in the endpoint Mailchimp audience, it will be ignored when being brought in from Race Roster.
Can webhooks remove contact data from the endpoint?
If you are setting up an automatically-updating webhook based on an automatically-updating retention report that has dwindling contacts (e.g., as the current year's event registrations increase, the number of past participants not yet registered diminishes), then you might expect the contact data being sent to the third party platform to result in the removal of a contact. Mailchimp is indeed compatible with this setup. Should you have feedback to submit or questions to ask on this topic, please contact us: director@raceroster.com
Comments
0 comments