---
title: "Create Embed Session"
method: POST
path: "/v1/embed/sessions"
tags: ["embed"]
---

# Create Embed Session

`POST /v1/embed/sessions`

Create a person + interview + session in a single call for embed integrations.

Returns the session_id and embed URL ready to pass to the Roxels.open() JS SDK.

## Request body

- EmbedSessionCreate
  - `template_id` string, required
  - `external_id` string, nullable
  - `person_name` string
  - `person_email` string, nullable
  - `person_metadata` object
  - `channel` string
  - `context` object, nullable

## Response `200`

Successful Response

- EmbedSessionOut
  - `session_id` string, required
  - `interview_id` string, required
  - `external_id` string, nullable
  - `embed_url` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/roxels/apis/interviewer.md) · [All operations](https://skmtc.dev/roxels/apis/interviewer/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roxels/interviewer/revisions/4ef48ed226e1/schema)