Create or update a customer. Creates or updates an end user. Matches by id, else external_id, else email, and creates them if none matches (email or external_id required then). Attributes are merged (null removes a key). company_ids links them to companies (IDs, external IDs or names; existing links stay). Team only; nobody is emailed. Pass expected_version when updating.
Toolset
customers
Who can call it
OwnersManagersContributorsAPI keys
REST
POST /api/v1/w/{workspace}/users
Behavior
changes dataidempotentaccepts idempotency_key
Input
Field
Type
Description
id
string
The user's ID, to update a known user.
email
string
external_id
string or null
name
string or null
avatar_url
string (uri) or null
attributes
object
Custom attributes to set, merged into the existing ones; a null value removes that key.
company_ids
array of string
Companies to link them to.
expected_version
integer
The user's version from your last read; the call fails if it changed since.
idempotency_key
string
Retry-safe key. Repeating a call with the same key returns the first result.