Endpoints

Create Event

Create a new event within your organization. Supports idempotent requests via the Idempotency-Key header.

POST/v1/partner/events

curl -X POST https://api.intervals.run/v1/partner/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

Idempotency-Keystring

Unique key to prevent duplicate creation on retry. UUID recommended.

Content-Typestringrequired

Must be application/json.

Body

application/json

namestringrequired

Event name.

slugstringrequired

URL-safe slug for the event.

typestringrequired

Event type.

raceclub-sessiontime-trial

datestringrequired

Event date. Format: YYYY-MM-DD.

seriesIdstring

Link event to an existing series.

endDatestring

Multi-day event end date. Format: YYYY-MM-DD.

startTimestring

Start time. Format: HH:MM.

endTimestring

End time. Format: HH:MM.

descriptionstring

Event description.

websiteUrlstring

Event website URL.

registrationUrlstring

Registration page URL.

Required Scope

write:events

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

curl -X POST https://api.intervals.run/v1/partner/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"
  }'

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