Identify
Identify a user and set their traits.
The identify call creates or updates a user in Accoil and sets traits such as email, name, and creation date.
Looking for the legacy v1 endpoint? See POST /v1/users.
POST
V2BasicApiKeyheader
Authorization<token>Use format "Basic API_KEY" where API_KEY is your unique Accoil API key. Found under Account > General settings.
User identification payload
application/json- body
timestamp?stringISO 8601 Formatted date string. Will default to UTC now if not supplied.
Format
date-timeuserId*stringA unique identifier for the user. Use the same ID as in external platforms (e.g., HubSpot, Intercom).
groupId?stringOptional. The external identifier for the account this user belongs to. Helps associate users with organizations.
traits?Optional. Key-value pairs describing user attributes, such as:
email: The user’s email address.name: The user’s full name.created_at: When the user first signed up (ISO 8601 format).role: The user's role in the account (e.g., "admin", "member").
Accepted
curl -X POST 'https://in.accoil.com/v2/identify' \ -H 'Content-Type: application/json' \ -d '{ "userId": "user_12345"}'Example Response
Empty