---
title: "Create or refresh an anonymous attendee session"
method: POST
path: "/v1/auth/anonymous"
tags: ["Auth"]
---

# Create or refresh an anonymous attendee session

`POST /v1/auth/anonymous`

## Request

- Base URL: `https://app.meet.ps/api`
- URL: `https://app.meet.ps/api/v1/auth/anonymous`
- Auth: none required

Generate a new attendee session for a would-be participant of one or more meetings, or get a refreshed access token for an existing one.

The endpoint provides a way to generate and refresh attendee access tokens to manage your attendees' sessions.

MeetingPulse supports three types of access tokens:
- ID tokens. These are used for API authentication, valid for 1 hour.
- Refresh tokens. These are used to generate new ID once old ones are expired.
- Generic/custom tokens. These are only valid in browser-based use cases and are consumed by MeetingPulse directly.

## Request body

- object
  - `refreshToken` string: Main account token to get a refresh token for. Required to reuse an existing attendee session - if missing, a new one will be created. Providing this will make the endpoint return an ID token.
  - `idToken` boolean: By default (with no parameters provided) the endpoint issues a normal token only. Use this flag if you need an ID token to go alongside.

## Response `200`

Authentication data for the attendee session

- object
  - `result` object
    - `token` string: A short-lived JWT token for browser consumption. Cannot be used to authenticate against the API.
    - `idToken` string: A short-lived JWT token (1h) suitable for making API requests on behalf of the attendee user.
    - `refreshToken` string: A long-lived refresh token to request fresh ID tokens.
    - `uid` string: MeetingPulse user ID for the attendee session in question

## Other responses

- `422`: Invalid refresh token has been provided

---

[API](https://skmtc.dev/meet/apis/meetingpulse-api.md) · [All operations](https://skmtc.dev/meet/apis/meetingpulse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meet/apis/meetingpulse-api/revisions/dc29466adc0e?raw)