---
title: "Create identity"
method: POST
path: "/identity"
tags: ["identity"]
---

# Create identity

`POST /identity`

Create a new identity profile. Two request forms are supported: the simple audio-only form (flat `name` + one audio source; creates a team-visible person identity and enrolls the voice immediately) and the multimodal form (a nested `identity` object with full control over type and visibility).

## Headers

- `Authorization` string, required

## Request body

- union
  - IdentityCreateIdentityRequest0
    - `name` string, required — Speaker name/identifier
    - `url` string, uri — URL to an audio sample (one of url, audio, signed_id is required)
    - `signed_id` string — Signed ID from a secure upload
  - IdentityCreateIdentityRequest1
    - `identity` IdentityPostRequestBodyContentApplicationJsonSchemaOneOf1Identity, required
      - `name` string, required
      - `identity_type` 'person' | 'brand'
      - `visibility` 'team' | 'global'
      - `notes` string
      - `voice_profile_id` string

## Response `200`

Identity created (simple form)

- IdentityCreateIdentityResponse200
  - `success` boolean — Whether the voice was enrolled for matching immediately
  - `item` IdentitySummary — Identity summary returned by the list and simple-create endpoints
    - `uuid` string
    - `name` string
    - `created_at` string, date-time
    - `audio_url` string, uri, nullable — URL of the first voice sample, if any
    - `visibility` 'team' | 'global'
    - `identity_type` 'person' | 'brand'
    - `notes` string, nullable
    - `voice_profile_id` string, nullable
    - `updated_at` string, date-time
    - `project_count` integer

## Other responses

- `422` — Validation failed or no audio source supplied

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-07-26** `5e92bebbaf1f` — 1 breaking, 2 warning, 12 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `audio_url`
  - removed the request property `name`
  - added `#/components/schemas/IdentityCreateIdentityRequest0, #/components/schemas/IdentityCreateIdentityRequest1` to the request body `oneOf` list
  - …11 more

[Change history](https://skmtc.dev/resemble/apis/api-reference/changes/identity/post.md)

---

[API](https://skmtc.dev/resemble/apis/api-reference.md) · [All operations](https://skmtc.dev/resemble/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resemble/api-reference/revisions/e93597a6b425/schema)