Intervals Developers
API Reference
Sign inGet API key
IntroductionAuthenticationErrorsPaginationRate LimitsIdempotency

Endpoints

GETYour organizationGETAll eventsGETRetrieve an eventPOSTCreate an eventGETAll registrationsPOSTRegister a participantGETAll recurrencesGETAll collectionsGETRetrieve a collectionGETEvents in a collection
Changelog
Sign inGet API key

Endpoints

Create an event

Add a new event to your organization. Requires an Idempotency-Key header so retries never create duplicates.

POST/events
curl -X POST https://api.intervals.run/events \
  -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Solstice 10K",
    "slug": "summer-solstice-10k",
    "type": "race",
    "date": "2025-06-21",
    "startTime": "07:30",
    "description": "Celebrate the longest day with a scenic 10K.",
    "websiteUrl": "https://northshorerace.com/solstice-10k",
    "registrationUrl": "https://runsignup.com/solstice-10k"
  }'

Headers

Content-Typestringrequired

Must be application/json.

Idempotency-Keystringrequired

Required. Unique key that makes creation safe to retry — resending the same key replays the original result. UUID recommended.

Request Body

application/json

namestringrequired

Event name

slugstring

URL slug. Optional — omit to derive from the name. Sanitized server-side.

typeenum<string>required

Event type

Available options: race,runClub,timeTrial,other

datestringrequired

Event date (YYYY-MM-DD)

endDatestring

End date for multi-day events (YYYY-MM-DD)

startTimestring

Start time (HH:MM or HH:MM:SS)

endTimestring

End time (HH:MM or HH:MM:SS)

addressobject

Event location

latnumber

Latitude

lngnumber

Longitude

descriptionstring

Event description

websiteUrlstring

Event website URL

registrationUrlstring

Registration page URL

Authorization

write:events
{
  "data": {
    "eventId": "e83ghi012jkl345"
  }
}

What you can build

Retrieve an eventAll registrations

Request

curl -X POST https://api.intervals.run/events \
  -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Summer Solstice 10K",
    "slug": "summer-solstice-10k",
    "type": "race",
    "date": "2025-06-21",
    "startTime": "07:30",
    "description": "Celebrate the longest day with a scenic 10K.",
    "websiteUrl": "https://northshorerace.com/solstice-10k",
    "registrationUrl": "https://runsignup.com/solstice-10k"
  }'

Response

{
  "data": {
    "eventId": "e83ghi012jkl345"
  }
}