---
title: "Create Widget"
method: POST
path: "/v1/widgets"
tags: ["Widgets"]
---

# Create Widget

`POST /v1/widgets`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/widgets`
- Auth: HTTP bearer

Create a new chat widget.

## Request body

- CreateWidgetRequest
  - `agent_id` string, required
  - `name` string, required
  - `greeting_message` string
  - `placeholder_text` string
  - `primary_color` string
  - `position` string
  - `avatar_url` string, nullable
  - `show_branding` boolean
  - `language` string
  - `auto_open` boolean
  - `auto_open_delay_ms` integer
  - `allowed_domains` string[], nullable
  - `voice_greeting_enabled` boolean
  - `voice_greeting_voice` string
  - `voice_mode` string
  - `voice_session_limit_sec` integer

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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