---
title: "Register someone for a session"
method: POST
path: "/sessions/{id}/people"
tags: ["Sessions"]
---

# Register someone for a session

`POST /sessions/{id}/people`

## Request

- Base URL: `https://api.livestorm.co/v1`
- URL: `https://api.livestorm.co/v1/sessions/{id}/people`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.livestorm.co/oauth/authorize`
    - Token URL: `https://app.livestorm.co/oauth/token`

Register a new participant for a session (either an external registrant or internal team member).

## Path parameters

- `id` string, required

## Request body

- object
  - `data` object
    - `type` string
    - `attributes` object
      - `fields` object[]
        - `id` string
        - `value` string
      - `referrer` string
      - `utm_source` string
      - `utm_medium` string
      - `utm_term` string
      - `utm_content` string
      - `utm_campaign` string

## Response `201`

Created

- object
  - `data` object, required: Data
    - `id` string: ID
    - `type` string: Type
    - `attributes` object: Attributes
      - `role` string
      - `created_at` integer
      - `updated_at` integer
      - `timezone` string
      - `first_name` string
      - `last_name` string
      - `email` string
      - `avatar_link` string
      - `registrant_detail` object

## Other responses

- `400`: Bad request
- `401`: Authentication failed
- `402`: Active contacts allowance reached. To add more registrants, please upgrade your plan
- `403`: Workspace blocked
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/livestorm/apis/livestorm-public-api.md) - [All operations](https://skmtc.dev/livestorm/apis/livestorm-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/livestorm/apis/livestorm-public-api/revisions/9292f597e878?raw)