Users

A user record represents a person in your workspace: an operator handling tickets, or a customer on the other side of a conversation.

Shape

Field	Type	Notes
`id`	number	Unique identifier
`email`	string	Primary address
`phone`	string	Contact number
`active`	boolean	Whether the user is active
`organization`	string	Organisation they belong to
`avatar`	string	Avatar URL
`bio`	string	Free-text biography
`location` / `country`	string	Where they are
`birthday`	string	Date of birth
`last_seen`	string	Last activity
`last_typed`	string	Last typing activity — useful for live presence

last_seen and last_typed drive presence indicators. last_typed updates far more often than last_seen, so poll it only when you’re rendering a live view.

Endpoints

Method	Path
`GET`	`/v1/users`	List
`GET`	`/v1/users/:id`	Get
`POST`	`/v1/users`	Create
`PUT`	`/v1/users/:id`	Update
`DELETE`	`/v1/users/:id`	Delete

Example

curl https://api.stateset.com/v1/users/42 \
  -H "Authorization: Bearer $STATESET_API_KEY"

curl -X POST https://api.stateset.com/v1/users \
  -H "Authorization: Bearer $STATESET_API_KEY" \
  -H 'content-type: application/json' \
  -d '{
    "email": "jordan@example.com",
    "organization": "Acme",
    "active": true
  }'

User records hold personal data — email, phone, location, birthday. Deleting a user is a DELETE on the record; if you have retention or erasure obligations, that is the endpoint that satisfies them, and it is not reversible.

Messages — messages reference user_id
Settings — assignee_user_id and escalation targets

Delete Session List Users

StateSet One API

StateSet API v1

Customer Management

Order Management

Checkouts

Returns Management

Warranty Management

Wholesale Management

Inventory Management

ASN Management

Purchase Orders

Manufacturing

Warehouse Operations

CRM

Suppliers

E-commerce

Financial

Fulfillment

Communication

System

StateSet Response API

StateSet Commerce API

StateSet Cloud API

Users

Users

Shape

Endpoints

Example

​Users

​Shape

​Endpoints

​Example

​Related

Users

Shape

Endpoints

Example

Related