Docs

createUser

Creates a new User. When creating a new User, the required tags must be provided. See the specific integration for more details.

POST/v1/chat/users

Authorization

AuthorizationBearerrequired
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Header parameters

x-bot-idstringrequired
Bot id
x-integration-idstring
Integration id
x-integration-aliasstring
Integration alias

Request body

User data

tagsobjectrequired
Tags for the User
integrationNamestringdeprecated
[DEPRECATED] To create a User from within a bot, call an action of the integration instead.(max length: 200)
namestring
Name of the user(max length: 200)
pictureUrlstring
URI of the user picture(max length: 40000)
propertiesobject
EXPERIMENTAL - Optional shared properties that can be accessed and modified by both the bot and any of its integrations.
attributesobjectdeprecated
DEPRECATED - Use properties instead.

Response

Returns a User object if creation succeeds. Returns an Error otherwise

userobjectrequired
The user object represents someone interacting with the bot within a specific integration. The same person interacting with a bot in slack and messenger will be represented with two different users.