POST
/
v1
/
public
/
users

This endpoint allows you to upsert new or existing Users. If the user already exists, it will be updated with the new data. Any property left unchanged will not be modified. Changes to tracking events are append-only.

Authorizations

Authorization
string
headerrequired

Authentication header of the form Bearer: <token>, where <token> is either your public or private API key. See when to use which

Body

application/json
userId
string
required

The ID of the user as defined in your own application

properties
object

Optional properties to add to the user

bootstrapFlowStates
boolean

If set to true, the user will automatically complete any eligible Flows with completionCriteria that have not already been completed. This is useful if a Flow has been recently updated with new steps and you want to ensure that historic users complete the new steps

events
object[]

Optional tracking events to add to the user

linkGuestId
string

Merges a guest with a non-guest user. Only works if the provided linkGuestId is a guest user and the userId does not yet have any state in any Flows.