Sign in
admin

Create an Identity

This endpoint creates an identity. It is NOT possible to set an identity's credentials (password, ...) using this method! A way to achieve that will be introduced in the future.

Learn how identities work in Ory Kratos' User And Identity Model Documentation.

post/identities

Request body

schema_idstring required

SchemaID is the ID of the JSON Schema to be used for validating the identity's traits.

traitsobject required

Traits represent an identity's traits. The identity is able to create, modify, and delete traits in a self-service manner. The input will always be validated against the JSON Schema defined in schema_url.

Example request

{
  "traits": "{}",
  "schema_id": "schema_id"
}

Response

A single identity.

idstring uuid4 required
schema_idstring required

SchemaID is the ID of the JSON Schema to be used for validating the identity's traits.

schema_urlstring required

SchemaURL is the URL of the endpoint where the identity's traits schema can be fetched from.

format: url

traitsobject required

Example response

{
  "recovery_addresses": [
    {
      "id": "id",
      "value": "value",
      "via": "via"
    },
    {
      "id": "id",
      "value": "value",
      "via": "via"
    }
  ],
  "traits": "{}",
  "verifiable_addresses": [
    {
      "verified_at": "2000-01-23T04:56:07.000+00:00",
      "verified": true,
      "id": "id",
      "value": "value",
      "status": "status",
      "via": "via"
    },
    {
      "verified_at": "2000-01-23T04:56:07.000+00:00",
      "verified": true,
      "id": "id",
      "value": "value",
      "status": "status",
      "via": "via"
    }
  ],
  "schema_id": "schema_id",
  "schema_url": "schema_url",
  "id": "id"
}

Changes