# Request a new TrueIdentity

`POST /identity/request`

Request an identity for a given person. Requires seed data to be provided.

Once approved (or cancelled), you will receive a callback via webhook. See below.

To receive a callback, you must configure a webhook URL in your user portal, and subscribe to the 'TrueIdentity Actions' webhook.

Note an error code of INTERNAL_ERROR_EMAIL 'E2002' will be returned if the email fails to send.
In this case the request will still be created and the user will be able to complete their TrueIdentity using the redirect URL.
The code and redirect_url will be provided inside the `details` object of the error response.

Parameters, request body, responses and error codes for this
endpoint are generated from the OpenAPI description. Read it at
/dist/docs/openapi.yaml for the machine-readable version.