---
title: "Create a call"
method: POST
path: "/calls"
---

# Create a call

`POST /calls`

## Request

- Base URL: `https://public-api.leexi.ai/v1`
- URL: `https://public-api.leexi.ai/v1/calls`
- Auth: API key in header `Authorization`

Create a call or meeting asynchronously (creation time is typically a few minutes). You must first finish uploading the recording of the call using a presigned recording url retrieved with the [Request a presigned url](/reference/request-a-presigned-url) endpoint. Use the [LIST users](/reference/list-users) endpoint to find the user_uuid to use in this request.

## Request body

- object
  - `custom_fields` object: Free-form key/value pairs stored on the call and returned as-is by the [LIST calls](/reference/list-calls) and [GET call](/reference/get-call) endpoints. Only for custom integrations agreed with Leexi: the keys and their meaning must be defined with the Leexi team beforehand, otherwise the values are stored but never used. Values must be scalars (string, number, boolean or null).
  - `customers` object[]: The external participants (customers) of the call. An array of objects, each accepting any of `name`, `email`, `phone_number` and `uuid` (only one attribute is required per object). When `uuid` is set it links an existing customer and the other attributes are ignored; unknown uuids are skipped. The provided names are used to help identify the speakers in the transcript. Prefer this over the deprecated `emails` and `raw_phone_number` params. ⚠️ Cannot be combined with the deprecated `emails` or `raw_phone_number` params in the same request (returns a 400).
    - `email` string
    - `name` string
    - `phone_number` string
    - `uuid` string: uuid of an existing customer to link
  - `description` string
  - `direction` string, required: inbound or outbound
  - `emails` string[]: ⚠️ DEPRECATED — kept for backward compatibility only. A list of emails of other participants in the call. Use `participating_user_uuids` (for fellow Leexi users) and the `customers` array (for external participants) instead. Cannot be combined with `customers` or `participating_user_uuids` in the same request (returns a 400).
  - `external_id` string, required: the id of the call in your system
  - `locale` string: fr-FR en-US de-DE es-ES nl-NL ar-AE da-DK hi-IN id-ID it-IT ja-JP ko-KR nb-NO pl-PL pt-PT ru-RU sv-SE tr-TR uk-UA zh-CN fr-CA he-IL th-TH bg-BG cs-CZ el-GR et-EE fi-FI hr-HR hu-HU lt-LT lv-LV ro-RO vi-VN en-AU en-GB en-NZ en-IN ca-ES
  - `participating_user_uuids` string[]: uuids of fellow Leexi users participating in the call (in addition to the owner set via `user_uuid`). Use the [LIST users](/reference/list-users) endpoint to find them. ⚠️ Cannot be combined with the deprecated `emails` or `raw_phone_number` params in the same request (returns a 400).
  - `performed_at` string, required: iso8601 format
  - `raw_phone_number` string: ⚠️ DEPRECATED — kept for backward compatibility only. A string representation of the customer's phone_number. Use the `customers` array instead (set its `phone_number` attribute). Cannot be combined with `customers` or `participating_user_uuids` in the same request (returns a 400).
  - `recording_s3_key` string, required: the recording_s3_key returned by the [Request a presigned url](/reference/request-a-presigned-url) endpoint
  - `tags` string[]: an array of tag names
  - `title` string: The title of the call or meeting
  - `user_uuid` string, required: The uuid of the user associated to the call, must have an active license.

## Response `200`

200

- object
  - `message` string

## Other responses

- `400`: 400

---

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