---
title: "Create an identity"
method: POST
path: "/v1/compliance/identities"
tags: ["compliance"]
---

# Create an identity

`POST /v1/compliance/identities`

## Request

- Base URL: `https://us1.platform.bird.com`
- URL: `https://us1.platform.bird.com/v1/compliance/identities`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `bird_session`

Stores a party you register on behalf of, so its business details can prefill
the countries you register in next.

An identity belongs to the workspace that creates it. Register the same party
from another workspace and it is a party of its own there, reviewed on its own
terms.

You can name a party now and fill its business details in later. Required
details depend on the destination country and are validated when you submit a
registration.

## Headers

- `Idempotency-Key` string
- `X-Workspace-Id` string
- `X-Organization-Id` string

## Request body

- ComplianceIdentityCreate
  - `name` string, required: What you call this party. Yours to choose; it is never sent to a carrier.

## Response `201`

The identity.

- ComplianceIdentity: A party you register on behalf of: your own business, or one of your clients. Reusing an identity across registrations is what stops you retyping the same business details for every country, and lets a fact reviewed once stand for the registrations that follow.
  - `id` string, required
  - `name` string, required: What you call this party. Yours to choose; it is never sent to a carrier.
  - `answers` object, required: The business details this party has supplied, keyed by requirement. Filled in for you: a single-value detail lands here the moment you file it on one of your registrations, so the next one prefills it rather than asking again. Only requirements a country marks as being about the party appear; anything about a specific sender is asked fresh each time.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Insufficient permissions
- `404`: Resource not found
- `409`: Resource conflict
- `422`: Validation failed
- `429`: Rate limit exceeded
- `500`: Internal server error
- `503`: The service is temporarily unavailable. If `Retry-After` is present, wait for that delay before retrying; otherwise, retry with exponential backoff. Reuse the same idempotency key and request when retrying a mutation.

## Changes

- **2026-10-20** `a1977645a499`: 1 info
  - endpoint added
- **2026-10-20** `6cec81ac4862`: 1 breaking
  - api path removed without deprecation
- **2026-10-20** `3e2a50466454`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/messagebird/apis/bird-api/changes/v1/compliance/identities/post.md)

---

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