1. RunSignup
  2. API
  3. Methods
  4. Add/Edit Race Groups/Teams

Add/Edit Race Groups/Teams

Add or edit race groups/teams. To edit a group/team, include the team_id field with the group information. The team_gender field is required for groups types with require_gender_selection set to "T". The team_age_restriction_id field is required for groups types with require_age_range_selection set to "T".

For JSON requests, the request should look like the example below.

{
	"race_teams": [
		{
			"team_id": 12345,
			"team_name": "API Team 1",
			"team_type_id": 1123,
			"team_age_restriction_id": null,
			"team_gender": "F",
			"team_bib_num": 1
		},
		{
			"team_name": "API Team 2",
			"team_type_id": 1123,
			"team_age_restriction_id": null,
			"team_gender": "M",
			"team_bib_num": 2
		},
		{
			"team_name": "API Team 1",
			"team_type_id": 1123,
			"team_age_restriction_id": null,
			"team_gender": "C",
			"team_bib_num": 3
		}
	]
}

For XML requests, the request should look like the example below.

<race_teams>
	<race_team>
		<team_id>12345</team_id>
		<team_name>API Team 1</team_name>
		<team_type_id>1123</team_type_id>
		<team_age_restriction_id></team_age_restriction_id>
		<team_gender>F</team_gender>
		<team_bib_num>1</team_bib_num>
	</race_team>
	<race_team>
		<team_name>API Team 2</team_name>
		<team_type_id>1123</team_type_id>
		<team_age_restriction_id></team_age_restriction_id>
		<team_gender>M</team_gender>
		<team_bib_num>2</team_bib_num>
	</race_team>
	<race_team>
		<team_name>API Team 3</team_name>
		<team_type_id>1123</team_type_id>
		<team_age_restriction_id></team_age_restriction_id>
		<team_gender>C</team_gender>
		<team_bib_num>3</team_bib_num>
	</race_team>
</race_teams>

For CSV requests, the request should look like the example below.

team_id,team_name,team_type_id,team_age_restriction_id,team_gender,team_bib_num
12345,API Team 1,1123,,F,1
,API Team 2,1123,,M,1
,API Team 3,1123,,C,1

URL

https://www.givesignup.org/rest/race/:race_id/teams

HTTP Method

POST

Standard Parameters

Parameter HTTP Method Default Description Datatype
api_key GET API Key string
api_secret GET API Secret string
tmp_key GET Temporary API Key from login API call. This should NOT be used in combination with API Key. string
tmp_secret GET Temporary API Secret from login API call. This should NOT be used in combination with API Secret. string
rsu_api_key GET API v2 key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET. string
sp_api_key GET Super partner API key. If used, you must send the API secret in an HTTP header named X-RSU-API-SECRET. string
X-RSU-API-SECRET HTTP Header API v2 or super partner secret. string
format GET xml Format of response. The default if not sent is `xml`, but `json` is preferred. format

Parameters

Parameter HTTP Method Default Description Datatype
race_id
Required
POST ID of race. uint
event_id
Required
GET Id of event or list of event ids separated by commas. id_list
request_format POST xml Format of request. The default if not sent is `xml`, but `json` is preferred. format
request
Required
POST Request in proper format. string

If you continue to use this site, you consent to use all cookies. We use cookies to offer you a better browsing experience. Read how we use cookies and how you can control them by visiting our Privacy Policy.

If you continue to use this site, you consent to use all cookies.