v171

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0726249111.7 MB

Identities

Create an identity

Creates a new identity with a unique external_id. If an identity with the same external_id already exists, the operation will fail.

post/v2/identities

external_idstring required

Customer-provided stable identifier for this identity. Must be unique within the workspace.

display_namestring

Human-readable display name for the identity.

emailstring

Email address associated with the identity.

avatar_urlstring

URL of the identity avatar image.

tagsstring[]

Free-form labels used to organize and filter identities.

metadataobject

Custom JSON metadata stored with the identity.

Identity created successfully.