LIlivestorm
Sessions

Update a contact in a session

Update a contact's registration data for a specific session. This endpoint allows updating UTM tracking data (referrer, utm_source, utm_medium, etc.) and custom registration fields. Protected fields like email cannot be modified. For a team member, it also sets their role on this session (session_role). The role adds to the event's default roles, the member's event-level role and their workspace role: a lower session role does not remove what those already allow, so an event organizer set to session viewer stays an organizer. The event owner's session role cannot be set.

patch/sessions/{period_id}/people/{id}

Request

  • Base URL
    https://api.livestorm.co/v1
  • Auth
    • API key in header Authorization
    • or OAuth 2
      Authorization code: https://app.livestorm.co/oauth/authorize
      Token URL: https://app.livestorm.co/oauth/token

Path parameters

period_idstring required

Session ID

idstring required

Contact (Person) ID

Request body

Example request

{
  "data": {
    "type": "people",
    "attributes": {
      "referrer": "https://example.com",
      "utm_source": "google",
      "utm_medium": "cpc",
      "utm_term": "webinar",
      "utm_content": "banner",
      "utm_campaign": "spring_2024",
      "session_role": "speaker",
      "fields": [
        {
          "id": "first_name",
          "value": "John"
        },
        {
          "id": "company",
          "value": "Livestorm"
        }
      ]
    }
  }
}

Response

Contact updated with custom fields

Changes

No recorded changes to this operation across all 1 revision of this API.