---
title: "Create Escalation"
method: POST
path: "/integrations/escalations"
tags: ["integrations"]
---

# Create Escalation

`POST /integrations/escalations`

## Request

- Base URL: `https://studio-api.meganova.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://studio-api.meganova.ai/integrations/escalations`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Create an escalation from a chat session.

This will create a ticket in the configured helpdesk provider.

## Request body

- EscalationCreate: Schema for creating an escalation.
  - `chat_session_id` string, uuid, required
  - `character_id` string, uuid, required
  - `space_id` string, uuid, required
  - `customer_email` string, email, required
  - `customer_name` string, nullable
  - `reason` string: Escalation reason
  - `provider_id` string, nullable: Specific provider to use (optional)

## Response `201`

Successful Response

- EscalationResponse: Response schema for escalation.
  - `id` string, uuid, required
  - `space_id` string, uuid, required
  - `chat_session_id` string, uuid, required
  - `character_id` string, uuid, required
  - `integration_id` string, uuid, required
  - `external_ticket_id` string, nullable
  - `external_ticket_url` string, nullable
  - `reason` string, required
  - `sentiment_score` number, nullable
  - `ai_confidence` number, nullable
  - `conversation_summary` string, nullable
  - `status` string, required
  - `external_status` string, nullable
  - `error_message` string, nullable
  - `resolved_at` string, date-time, nullable
  - `resolution_notes` string, nullable
  - `customer_email` string, nullable
  - `customer_name` string, nullable
  - `credits_used` integer, required
  - `response_time_ms` integer, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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