Skip to main content
POST
Get Or Create User

Headers

x-user-key
string
required

Authentication Key

Body

application/json

User data

name
string

Name of the User (not a unique identifier)

pictureUrl
string

Picture url of the User

profile
string

Custom profile data of the User encoded as a string

Maximum string length: 1000

Response

Returns a User

user
object
required

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.

Last modified on March 24, 2026