---
title: "Create an identity"
canonical: "https://bird.com/docs/api/reference/create-compliance-identity"
---

# Create an identity

`POST /v1/compliance/identities`

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.

## Code samples

**TypeScript**

```ts
await bird.complianceIdentities.create({ name: "Goldcrest" });
```

Examples: [TypeScript](/docs/api/reference/create-compliance-identity.ts.md) · [Python](/docs/api/reference/create-compliance-identity.py.md) · [Go](/docs/api/reference/create-compliance-identity.go.md) · [PHP](/docs/api/reference/create-compliance-identity.php.md) · [cURL](/docs/api/reference/create-compliance-identity.curl.md)

## Example response `201`

```json
{
  "id": "cid_01krdgeqcxet5s7t44vh8rt9mg",
  "name": "Goldcrest Communications SAS"
}
```

## Request body

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

## Response body

- `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, required)
- `updated_at` (string, required)

## Related resources

- [Should I use a Bird SDK or call the API directly?](/explained/platform/should-i-use-an-sdk-or-call-the-api-directly) (answer)
- [Build your first integration](/learn/paths/integration) (course)
- [Send your first email](/docs/get-started/send-your-first-email) (docs)

[Get an implementation brief](/learn/workspace?topic=api-basics)