# Create Identity

Create single Identity owned by your account.

## Request

HTTP Method: `POST`

URI Path: `/v3/identities/`

### Includes

| Value | Description |
| --- | --- |
| country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) |
| birth\_country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) |
| proofs | [Proofs Object](../proofs/proofs-object.html#proofs-object-v34) |
| addresses | [Addresses Object](../addresses/address-object.html#addresses-object-v34) |
| addresses.country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) |
| proofs.proof\_type | [Proof Types Object](../proof-types/proof-types-object.html#proof-types-object-v34) |
| permanent\_documents | [Permanent Documents Object](../permanent-documents/permanent-documents-object.html#permanent-documents-object-v34) |
| permanent\_documents.template | [Supporting Document Template Object](../supporting-document-templates/supporting-document-templates-object.html#supporting-document-templates-object-v34) |

### Request Body Object Attributes

PersonalBusiness

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| first\_name | `string` | Yes | First name of the personal identity. |
| last\_name | `string` | Yes | Last name of the personal identity. |
| phone\_number | `string` | Yes | Phone number of the personal identity. |
| personal\_tax\_id | `string` | No | Personal tax ID of the personal identity. |
| birth\_date | `string` | No | Birth date of the personal identity in ISO 8601 format. |
| id\_number | `string` | No | ID number of the personal identity. |
| description | `string` | No | Description of the personal identity. |
| external\_reference\_id | `string` | No | Identifier for identity in external system |
| identity\_type | `string` | Yes | Type of identity. Write `personal` to create a personal identity. |
| contact\_email | `string` | No | Contact email address of identity. |

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| company\_name | `string` | Yes | Company name of the business identity. |
| company\_reg\_number | `string` | No | Company registration number of the business identity. |
| vat\_id | `string` | No | Company VAT ID of the business identity. |
| first\_name | `string` | Yes | Company's representative First name of the business identity. |
| last\_name | `string` | Yes | Company's representative Last name of the business identity. |
| phone\_number | `string` | Yes | Company's representative Phone number of the business identity. |
| personal\_tax\_id | `string` | No | Company's representative Tax ID of the business identity. |
| birth\_date | `string` | No | Company's representative Birth date of the business identity in ISO 8601 format. |
| id\_number | `string` | No | Company's representative ID number of the business identity. |
| description | `string` | No | Company's representative description of the business identity. |
| external\_reference\_id | `string` | No | Identifier for identity in external system. |
| identity\_type | `string` | Yes | Identity type. Write `business` to create a business identity. |
| contact\_email | `string` | No | Contact email address of identity. |

### Request Body Object Relationships

| Title | Type | Description |
| --- | --- | --- |
| country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) | Specifies the country for identity. |
| birth\_country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v34) | Specifies the birth country for identity. In version `2026-04-16`, it is handled separately from `country` and is not auto-assigned. |

Note

Assigning `country` does not automatically assign `birth_country`. Set `birth_country` explicitly when needed.

## Examples

Create Personal IdentityCreate Personal Identity with Country and Birth CountryCreate Business Identity

[[DIDWW-API-EXAMPLE-START]]

http

```
POST /v3/identities HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

{
  "data": {
    "type": "identities",
    "attributes": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "birth_date": null,
      "id_number": "string",
      "description": "string",
      "personal_tax_id": "string",
      "external_reference_id": "string",
      "identity_type": "personal",
      "contact_email": "string"
    }
  }
}
```

curl

```
curl -i -X POST https://api.didww.com/v3/identities -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --data-raw '{"data": {"attributes": {"birth_date": null, "contact_email": "string", "description": "string", "external_reference_id": "string", "first_name": "string", "id_number": "string", "identity_type": "personal", "last_name": "string", "personal_tax_id": "string", "phone_number": "string"}, "type": "identities"}}'
```

response

```
HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
  "data": {
    "id": "39623bf9-381f-4da6-ab29-2d3eb8783d81",
    "type": "identities",
    "attributes": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "id_number": "string",
      "birth_date": null,
      "company_name": null,
      "company_reg_number": null,
      "vat_id": null,
      "description": "string",
      "personal_tax_id": "string",
      "identity_type": "personal",
      "created_at": "2021-03-22T11:53:32.240Z",
      "external_reference_id": null,
      "verified": false,
      "contact_email": "string"
    },
    "relationships": {
      "country": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/country",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/country"
        }
      },
      "proofs": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/proofs",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/proofs"
        }
      },
      "addresses": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/addresses",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/addresses"
        }
      },
      "permanent_documents": {
        "links": {
          "self": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/relationships/permanent_documents",
          "related": "https://sandbox-api.didww.com/v3/identities/39623bf9-381f-4da6-ab29-2d3eb8783d81/permanent_documents"
        }
      }
    }
  },
  "meta": {
    "api_version": "2026-04-16"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
POST /v3/identities HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

{
  "data": {
    "type": "identities",
    "attributes": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "birth_date": null,
      "id_number": "string",
      "description": "string",
      "personal_tax_id": "string",
      "external_reference_id": "string",
      "identity_type": "personal",
      "contact_email": "string"
    },
    "relationships": {
      "country": {
        "data": {
          "id": "c8647639-fc9c-47b2-acec-7c9e14465c25",
          "type": "countries"
        }
      },
      "birth_country": {
        "data": {
          "id": "c8647639-fc9c-47b2-acec-7c9e14465c25",
          "type": "countries"
        }
      }
    }
  }
}
```

curl

```
curl -i -X POST https://api.didww.com/v3/identities -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --data-raw '{"data": {"attributes": {"birth_date": null, "contact_email": "string", "description": "string", "external_reference_id": "string", "first_name": "string", "id_number": "string", "identity_type": "personal", "last_name": "string", "personal_tax_id": "string", "phone_number": "string"}, "relationships": {"birth_country": {"data": {"id": "c8647639-fc9c-47b2-acec-7c9e14465c25", "type": "countries"}}, "country": {"data": {"id": "c8647639-fc9c-47b2-acec-7c9e14465c25", "type": "countries"}}}, "type": "identities"}}'
```

response

```
HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
    "data": {
        "id": "874390d1-ea6f-47c0-8d30-c9baaaeebdd9",
        "type": "identities",
        "attributes": {
            "first_name": "string",
            "last_name": "string",
            "phone_number": "string",
            "id_number": "string",
            "birth_date": null,
            "company_name": null,
            "company_reg_number": null,
            "vat_id": null,
            "description": "string",
            "personal_tax_id": "string",
            "identity_type": "personal",
            "created_at": "2023-01-31T09:23:10.406Z",
            "external_reference_id": "string",
            "verified": false,
            "contact_email": "string"
        },
        "relationships": {
            "country": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/relationships/country",
                    "related": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/country"
                }
            },
            "birth_country": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/relationships/birth_country",
                    "related": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/relationships/birth_country"
                }
            },
            "proofs": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/relationships/proofs",
                    "related": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/proofs"
                }
            },
            "addresses": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/relationships/addresses",
                    "related": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/addresses"
                }
            },
            "permanent_documents": {
                "links": {
                    "self": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/relationships/permanent_documents",
                    "related": "https://api.didww.com/v3/identities/874390d1-ea6f-47c0-8d30-c9baaaeebdd9/permanent_documents"
                }
            }
        }
    },
    "meta": {
        "api_version": "2026-04-16"
    }
}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
POST /v3/identities HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API token]

{
  "data": {
    "type": "identities",
    "attributes": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "id_number": "string",
      "birth_date": "string",
      "company_name": "string",
      "company_reg_number": "string",
      "vat_id": "string",
      "description": "string",
      "personal_tax_id": "string",
      "external_reference_id": "string",
      "identity_type": "business",
      "contact_email": "string"
    },
    "relationships": {
      "country": {
        "data": {
          "id": "6d0effab-3fe3-4e07-acc6-1d3ddc717ebc",
          "type": "countries"
        }
      },
      "birth_country": {
        "data": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "type": "countries"
        }
      }
    }
  }
}
```

curl

```
curl -i -X POST https://api.didww.com/v3/identities -H "Accept: application/vnd.api+json" -H "Api-Key: [API token]" -H "Content-Type: application/vnd.api+json" --data-raw '{"data": {"attributes": {"birth_date": "string", "company_name": "string", "company_reg_number": "string", "contact_email": "string", "description": "string", "external_reference_id": "string", "first_name": "string", "id_number": "string", "identity_type": "business", "last_name": "string", "personal_tax_id": "string", "phone_number": "string", "vat_id": "string"}, "relationships": {"birth_country": {"data": {"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "type": "countries"}}, "country": {"data": {"id": "6d0effab-3fe3-4e07-acc6-1d3ddc717ebc", "type": "countries"}}}, "type": "identities"}}'
```

response

```
HTTP/1.1 201 Created
Content-Type: application/vnd.api+json

{
  "data": {
    "id": "fb7f3f67-014c-496b-b918-f874f2689a40",
    "type": "identities",
    "attributes": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "id_number": "string",
      "birth_date": null,
      "company_name": "string",
      "company_reg_number": null,
      "vat_id": null,
      "description": "string",
      "personal_tax_id": "string",
      "identity_type": "business",
      "created_at": "2021-03-22T12:08:29.987Z",
      "external_reference_id": null,
      "verified": false,
      "contact_email": "string"
    },
    "relationships": {
      "country": {
        "links": {
          "self": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/relationships/country",
          "related": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/country"
        }
      },
      "birth_country": {
        "links": {
          "self": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/relationships/birth_country",
          "related": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/relationships/birth_country"
        }
      },
      "proofs": {
        "links": {
          "self": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/relationships/proofs",
          "related": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/proofs"
        }
      },
      "addresses": {
        "links": {
          "self": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/relationships/addresses",
          "related": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/addresses"
        }
      },
      "permanent_documents": {
        "links": {
          "self": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/relationships/permanent_documents",
          "related": "https://api.didww.com/v3/identities/fb7f3f67-014c-496b-b918-f874f2689a40/permanent_documents"
        }
      }
    }
  },
  "meta": {
    "api_version": "2026-04-16"
  }
}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 401 | No | [Unauthorized](../../../configuration.html#api-key) |

On this page