What can I build with this endpoint?

You're running on another race platform and want Intervals' reach — publish your events here so they surface in intervals.run discovery, or migrate your calendar over when you're moving to Intervals for good. It's the way in; once an event lands, Intervals is the source of truth for it.

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) on the venue's clock. Send the venue's local date and times with no offset; the event's `timezone` is derived from its location.

endDatestring

End date for multi-day events (YYYY-MM-DD) on the venue's clock

startTimestring

Start time (HH:MM or HH:MM:SS) on the venue's clock, with no offset

endTimestring

End time (HH:MM or HH:MM:SS) on the venue's clock, with no offset

addressobject

Event location

latnumber

lngnumber

descriptionstring

Event description

websiteUrlstring

Event website URL

registrationUrlstring

Registration page URL

Authorization

write:events

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

What you can build

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"
  }
}