Create Identity Tag

This endpoint allows you to create a new identity tag for a customer. Identity Tags can be used to group your verifications

HTTP Request
POST {baseurl}/v1/api/identity

Request Body Parameters

Parameter Type Required Description
customer string Yes The unique identifier of the customer.
tag string Yes A distinctive tag for the identity. Must be unique for the customer.

Example Request

curl -X POST {baseurl}/v1/api/identity \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
        "customer": "6791457be570f7f292f1fe23",
        "tag": "Some Distinctive Tag"
    }'

Notes

  • Ensure the customer parameter is valid and exists in the system.
  • The tag must be unique for the specified customer.

Sample Response

{
    "id": "string",
    "organization": "string",
    "tag": "string",
    "customer": "string",
    "Artifacts": ["string"],
    "verified": true,
    "createdAt": "string",
    "updatedAt": "string"
}