Create an identity
In this guide you will learn how to create an identity in a space. This is a prerequisite to compute voiceprints or perform identity verifications.
If you are unfamiliar with these concepts, follow their links or read the API reference introduction.
✦ Goal: create an identity and store its reference for
future use.
Prerequisites
Set up your HTTP client
Use the playground or automatically generate requests from the OpenAPI definition.
Authenticate using your credentials or API keys
Your API requests must be authenticated using your credentials or API keys.
Gain access to a space
You can only operate in spaces that belong to your user or to one of your organizations. Review these relationships if your access is denied.
---> owner space
Procedure
Create the identity
Create the identity. See the API reference.
<--- owner space
Personally Identifiable Information (PII) should not be used as handles. Instead, use a transformation of your internal IDs to easily and securely map people across services.
---> ✦ identity
- Method —
POST - Path —
/spaces/{owner}/{space}/identities - Body —
application/json
{
"handle": "{identity}"
}
Validation
Validate the identity details
To validate that the identity has been correctly created, retrieve and analyze its details. See the API reference.
<--- owner space identity
- Method —
GET - Path —
/spaces/{owner}/{space}/identities/{identity}