Endpoints

Register Participant

POST/v1/partner/events/:id/participants

curl -X POST https://api.intervals.run/v1/partner/events/e72tuv901wxy234/participants \
  -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "eventRunId": "r41abc567def890",
    "email": "runner@example.com",
    "name": "Alex Johnson",
    "registrationType": "online",
    "registrationStatus": "confirmed",
    "source": "api",
    "paceGroup": "A"
  }'

Headers

Idempotency-Keystring

Unique key to prevent duplicate registration.

Content-Typestringrequired

Must be application/json.

Path Parameters

idstringrequired

The event ID.

Body

application/json

eventRunIdstringrequired

The specific event run (distance) to register for.

emailstringrequired

Participant email address.

registrationTypestringrequired

Registration type.

onlinein-persontransfercomp

registrationStatusstringrequired

Registration status.

confirmedpendingwaitlistedcancelled

sourcestringrequired

Registration source.

apimanualimportrunsignupwebsite

namestring

Participant display name.

paceGroupstring

Pace group assignment.

notesstring

Internal notes.

Required Scope

write:participants

{
  "data": {
    "participantId": "p89xyz345uvw678"
  }
}

curl -X POST https://api.intervals.run/v1/partner/events/e72tuv901wxy234/participants \
  -H "Authorization: Bearer INTERVALS_PARTNER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "eventRunId": "r41abc567def890",
    "email": "runner@example.com",
    "name": "Alex Johnson",
    "registrationType": "online",
    "registrationStatus": "confirmed",
    "source": "api",
    "paceGroup": "A"
  }'

{
  "data": {
    "participantId": "p89xyz345uvw678"
  }
}