> ## Documentation Index
> Fetch the complete documentation index at: https://docs.series.hr/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Attendee

> Add a player to session attendance

Add a player to an attendance session with join/leave timestamps (Premium/Enterprise only).

## Request

```bash theme={null}
curl -X POST https://api.series.hr/attendance/add-attendee/session_xyz789 \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "UserId": "714760171",
    "Username": "player_name",
    "JoinTime": "2024-01-15T10:30:00Z",
    "LeaveTime": "2024-01-15T11:45:00Z"
  }'
```

## Parameters

<ParamField body="UserId" type="string" required>
  Roblox user ID (required)
</ParamField>

<ParamField body="Username" type="string">
  Roblox username (optional)
</ParamField>

<ParamField body="DisplayName" type="string">
  Roblox display name (optional)
</ParamField>

<ParamField body="AvatarUrl" type="string">
  User's avatar URL (optional)
</ParamField>

<ParamField body="JoinTime" type="string">
  ISO 8601 join timestamp (optional)
</ParamField>

## Response

<ResponseField status={201} name="201">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "attendeeId": "attendee_12345",
      "sessionId": "session_xyz789",
      "UserId": "714760171",
      "JoinTime": "2024-01-15T10:30:00Z",
      "LeaveTime": "2024-01-15T11:45:00Z",
      "duration": 4500
    }
  }
  ```
</ResponseField>


## OpenAPI

````yaml POST /attendance/add-attendee/{sessionId}
openapi: 3.0.0
info:
  title: Series API
  version: 1.0.0
  description: >-
    Series API — a free REST API by Sailboat Games, LLC that lets Roblox
    communities programmatically manage workspaces, staff, sessions, time-off
    and activity data.
  contact:
    name: Sailboat Games, LLC.
    email: admin@sailboatgames.com
servers:
  - url: https://api.series.hr
    description: Production API
security:
  - ApiKeyAuth: []
paths:
  /attendance/add-attendee/{sessionId}:
    post:
      tags:
        - Attendance
      summary: Add Attendee
      description: >-
        Add a player to session attendance. Requires Premium or Enterprise
        subscription.
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
          description: The session ID
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - UserId
              properties:
                UserId:
                  type: string
                  description: The Roblox user ID (required)
                Username:
                  type: string
                  description: The Roblox username (optional)
                DisplayName:
                  type: string
                  description: The Roblox display name (optional)
                AvatarUrl:
                  type: string
                  description: The user's avatar URL (optional)
                JoinTime:
                  type: string
                  format: date-time
                  description: ISO 8601 timestamp of join time (optional)
      responses:
        '200':
          description: Attendee added
        '403':
          description: Premium/Enterprise subscription required
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
      description: >-
        Pass your API key in the `apikey` header. Alternatively, the `x-api-key`
        header is also accepted.

````