---
title: "Create Guest Session"
method: POST
path: "/v1/guest/session"
tags: ["guest"]
---

# Create Guest Session

`POST /v1/guest/session`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/guest/session`
- Auth: none declared

Create a new guest organization and session.

This allows self-service flows (hospice, MSA) to work without
requiring full user registration. The guest can later claim
their org by registering with the same email.

Every call creates a new guest org: the email is unverified, so it is
never used to look up (and hand out) an existing guest's org.

Returns a session token that can be used for authenticated API calls.

## Request body

- CreateGuestSessionRequest: Request to create a guest session.
  - `email` string, required
  - `source` string
  - `vertical` string, nullable

## Response `200`

Successful Response

- GuestSessionResponse: Response containing guest session details.
  - `org_id` string, required
  - `user_id` string, required
  - `session_token` string, required
  - `is_new` boolean, required

## Other responses

- `422`: Validation Error

---

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