Create identity

The identity creation process is necessary to enable authentication for a given user. Subsequent authentication attempts for this user will be compared against this created identity, based on the personId, while storing the user's context data. A clear selfie is required, used for facial validation.

Email and phone are optional for the API, but required if you intend to allow OTPs as a means of re-authenticating this user. In this case, in addition to enabling email or SMS in the authentication policy, users must have an email and phone number registered.

All calls to the API are authenticated and must have the token next to Bearer prefix in the Authorization header of the request. Calls with a missing or invalid access token will return status code 401 ("Unauthorized").

The token used to make requests to the API is the access token generated according to these instructions..

Create Identity of new users

Create Identity of new users.

POSThttps://api.identity.combateafraude.com/identities

Header parameters

Body

application/json

name*string

The name of the user who will be authenticated.

Example: "First Middle Last"

personId*string

The registry id of the user who will be authenticated. In Brazil, this id is the CPF

Example: "952.360.980-76"

imageUrl*string

The url of the selfie of the user who will be authenticated.

Example: "https://imageurlink.jpeg"

emailstring

The email of the user who will be authenticated.

Example: "[email protected]"

phonestring

The phone number of the user who will be authenticated. You must inform phone with country and region code. (country code + region code + phone)

Example: 5521982895497

Response

200400401500

Success

Body

application/json

requestId*string

Unique identifier of request.

Example: "xxxxx-cecd-4643-95c7-xxxxx"

id*string

Unique identifier of the identity.

Example: "123ab456789c123456d7e8fg"

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.identity.combateafraude.com/identities', {
    method: 'POST',
    headers: {
      "Authorization": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "name": "First Middle Last",
      "personId": "952.360.980-76",
      "imageUrl": "https://imageurlink.jpeg"
    }),
});
const data = await response.json();

Response

200400401500

{
  "requestId": "xxxxx-cecd-4643-95c7-xxxxx",
  "id": "123ab456789c123456d7e8fg"
}