Zapier - Actions, Searches, Release Notes

Modified on 18 April

Actions, Searches, Release Notes

TABLE OF CONTENTS


Actions

The RunSignup Zapier app does not have any actions at this time.



Searches

Find Fundraiser by ID

Find Fundraiser by ID searches for an existing Race Fundraiser in RunSignUp for the selected race by the Fundraiser’s ID.


The output of the Find Fundraiser by ID search returns a payload of data for the fundraiser, which may be used in subsequent actions. 


Find Fundraiser by ID was added to the RunSignup Zapier app to support automated search and return of details for a fundraiser using the ID of the fundraiser (i.e., exact match/search). This search is best for organizations and users that need to pull in additional details for a fundraiser associated with a registration or donation in RunSignup. 


Find Fundraiser by ID is a Zapier search and will always follow a trigger step, and potentially one or more actions (i.e., it is always Step 2 or any Step thereafter). Each Find Fundraiser by ID search added to a Zap will run once per Zap. 

Setup

Field

How it works/What it does

Race

  • Only applicable to users who authenticated using a Partner account (not Race Director).

  • This field is required. 

  • Users must select the desired Race for the Zap.

Fundraiser

  • This field is required. 

  • Users should dynamically map the fundraiser ID from the trigger or a preceding action.

Features and Functionality

Features:

  • Supports search for both individual and team fundraisers. 

  • The payload of data returned by this trigger includes the fundraiser details, including:

    • Amount raised

    • Number of donations

    • Fundraiser type info

    • Umbrella teams

    • External fundraiser IDs

    • Minimum commitment data


Behavior: 

  • This search runs based on the Race selected (if a Partner; if a Race Director, the race is defined in the authentication) and the mapped Fundraiser ID. 

  • This component employs the GET /get-race-fundraisers endpoint with the id passed in the fundraiser_id parameter to search for the existing fundraiser. 


Limitations:

  • This trigger will not create new fundraisers. It can only search for an existing fundraiser. 

  • Search does not support a search on any parameter except the fundraiser ID.

Get Participant Counts for a Race (All Events)

Get Participant Counts for a Race (All Events) returns the participant count for each event in RunSignup for the selected race.


The output of the Get Participant Counts for a Race (All Events) search returns a payload of data that includes the event id, event name, and the number of participants for each event in the selected Race, which may be used in subsequent actions. 


Get Participant Counts for a Race (All Events) was added to the RunSignup Zapier app to support automated search and return of participant counts for race events. This search is best for organizations and users that need to pull in participant counts on a scheduled frequency (e.g., daily, weekly, or monthly). 


Get Participant Counts for a Race (All Events) is a Zapier search and will always follow a trigger step, and potentially one or more actions (i.e., it is always Step 2 or any Step thereafter). Each Get Participant Counts for a Race (All Events) search added to a Zap will run once per Zap. 

Setup

Field

How it works/What it does

Race

  • Only applicable to users who authenticated using a Partner account (not Race Director).

  • This field is required. 

  • Users must select the desired Race for the Zap.

Features and Functionality

Features:

  • Returns the event id, event name, and number of participants for each event configured for the race in an array.


Behavior: 

  • This search runs based on the Race selected (if a Partner; if a Race Director, the race is defined in the authentication).

  • This component employs the GET /participant-counts endpoint with the race_id passed in the parameter to return the desired race details. 

  • The most_recent_events_only parameter is set to “T” to ensure only the current events for the race are returned.

Get Participant Counts for a Race (Single Event Only)

Get Participant Counts for a Race (Single Event Only) returns the participant count for a single, selected event in RunSignup for the selected race.


The output of the Get Participant Counts for a Race (Single Event Only) search returns a payload of data that includes the event id, event name, and the number of participants for the selected event, which may be used in subsequent actions. 


Get Participant Counts for a Race (Single Event Only) was added to the RunSignup Zapier app to support automated search and return of participant counts for a race event. This search is best for organizations and users that need to pull in participant counts on a scheduled frequency (e.g., daily, weekly, or monthly). 


Get Participant Counts for a Race (Single Event Only) is a Zapier search and will always follow a trigger step, and potentially one or more actions (i.e., it is always Step 2 or any Step thereafter). Each Get Participant Counts for a Race (Single Event Only) search added to a Zap will run once per Zap. 

Setup

Field

How it works/What it does

Race

  • Only applicable to users who authenticated using a Partner account (not Race Director).

  • This field is required. 

  • Users must select the desired Race for the Zap.

Event

  • This field is required. 

  • Users must select the desired Event for the Race selected  in the Zap.

Features and Functionality

Features:

  • Returns the event id, event name, and number of participants for the selected race event.


Behavior: 

  • This search runs based on the Race selected (if a Partner; if a Race Director, the race is defined in the authentication).

  • This component employs the GET /participant-counts endpoint with the race_id and event_id passed in the parameter to return the desired details for the selected event. 

  • The most_recent_events_only parameter is set to “T” to ensure only the current events for the race are returned.



Release Notes

1.0.1

Release Date: 2023-02-02T15:40:15+00:00

Migration Date: 2023-02-02T15:40:56+00:00


Summary: This release includes updates to tighten up usability features to help you build Zaps faster and with greater clarity on elements produced by the RunSignup API.


New

No updates in this release.


Improvements

  • Reformatting of custom questions — When custom questions are hydrated in the New Participation Registration trigger (based on user selection), the return will parse and format each separate custom question and response as {question label} :: {response}.

  • Event date — The New Participant Registration trigger now returns the start and end date/time for the event the participant registered for.


Fixed

No updates in this release.


Read more about the RunSignup Zapier app here.


1.1.0

Release Date: 2023-03-06T20:09:40+00:00

Migration Date: 2023-03-06T20:10:51+00:00

Summary: This release includes the addition of a new trigger component to expand automation use cases for RunSignup users.


New

  • Removed Participant Registration — Removed Participant Registration is a new trigger in the app. This trigger runs when a participant registration for the selected race is removed or cleared. 


Improvements

No updates in this release.


Fixed

No updates in this release.


1.1.2

Release Date: 2023-08-07T14:31:12+00:00

Migration Date: 2023-08-07T14:33:26+00:00

Summary: This release includes an update to the New Participant Registration component to support charity fundraisers.


New

No updates in this release.


Improvements

  • Fundraiser Details — The New Participant Registration trigger was updated to include an optional parameter to include fundraiser details for the registrant.


Fixed

No updates in this release.


1.1.3


Release Date: 2023-11-29T16:20:42+00:00

Migration Date:  2023-11-29T16:22:19+00:00

Summary: This release includes an update to the New Registration Add-on to return shipping

address details.


New

No updates in this release.


Improvements

Shipping Address — The New Registration Add-on trigger was updated to include

the shipping address details, when present on the add-on/registration.

Fixed

No updates in this release.


1.1.4

Release Date: 2023-12-21

Migration Date: n/a - Users were not migrated to this version. v1.1.4 was only shared with Corrigan Sports via invite URL.

Summary: This release includes an update to resolve errors returned when too many event IDs were passed from the GET race call to the GET participants call (i.e., for current and past events). 


New

No updates in this release.


Improvements

No updates in this release.


Fixed

  • Most Recent Events Only — The New Participant Registration, New Registration Add-on, and Removed Participant Registration triggers were updated to include an additional parameter in the GET race call (most_recent_events_only == T) to filter the event IDs returned and passed to the GET participants call. 




1.1.5

Release Date: 2024-01-02T16:31:00+00:00

Migration Date: 2024-01-02T16:37:15+00:00

Summary: This release includes an update to return the Registration Date as a date variable. 


New

No updates in this release.


Improvements

  • Registration Date only — The New Participant Registration, New Registration Add-on, and Removed Participant Registration triggers were updated to include an additional variable (Registration Date UTC) that returns the Registration Date as YYYY-MM-DD.


Fixed

No updates in this release.


1.2.2

Release Date: 2024-07-17T19:32:48+00:00

Migration Date: 2024-07-17T19:33:37+00:00

Summary: This release includes the addition of Fundraiser details in the New Donation trigger. 


New

No updates in this release.


Improvements

  • New Donation trigger updates. The New Donation trigger was updated to return:

    • Details about the race Fundraiser including raised amount, number of donations, fundraiser type info, umbrella teams, external fundraiser ids, minimum commitment, and import data

    • On behalf of labels


Fixed

No updates in this release.


1.2.3

Release Date: 2024-11-01T16:27:30+00:00

Migration Date: 2024-11-01T16:29:53+00:00

Summary: This release includes formatting of the Fundraiser details in the New Donation trigger.


New

No updates in this release.


Improvements

  • New Donation trigger updates. The New Donation trigger was updated to return only the most recent registration details for the hydrated Fundraiser.


Fixed

No updates in this release.

1.2.4

Release Date: 2025-02-18T20:08:45+00:00

Migration Date: 2025-02-18T20:09:40+00:00

Summary: This release includes a new search to find a fundraiser by the fundraiser ID and maintenance updates.


New

  • Find Fundraiser by ID. This search returns the fundraiser for a selected race by the fundraiser’s ID.


Improvements

  • Maintenance. RunSignup Zapier integration was updated to latest versions of Zapier's libraries and packages. 


Fixed

No updates in this release.


Backlog

The items below were noted for potential future development.


  • Development of Transfer components to sync historical race data created prior to go-live of the user’s Zapier solution. 


  • Development of an Updated Participant Registration trigger to account for changes to a participant’s registration following initial creation.