/v1/participants

Adds a participant to an existing event. Supply event_id, plus either a contact_id (to add an existing contact) or at least one of name, phone, or email (to create a participant from raw details).

The request body should look like the following:

{
  event_id: 123,
  name: "Fred Smith",
  phone: "+16505551212",
  email: "[email protected]"
}

To add an existing contact instead, pass its contact_id. The contact's details are used for the participant; name, phone, and email are optional overrides.

{
  event_id: 123,
  contact_id: 456
}

The created participant is returned in the same shape as /v1/participants:

{
  participant: {
    id: 789,
    event_id: 123,
    name: "Fred Smith",
    phone: "+16505551212",
    normalized_phone: "+16505551212",
    email: "[email protected]",
    state: "initial"
  }
}

OAuth scope

Calls authenticated with an OAuth 2.0 bearer token must include the events:write scope. A token without it receives a 403 insufficient_scope response. HTTP Basic auth is not scope-gated.