Docs

getOrCreateUser

Retrieves the User object for given discriminating tags. If the user does not exist, it will be created. If the user already exists, its name, pictureUrl, attributes, and tags will be updated with the provided values.

POST/v1/chat/users/get-or-create

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.
discriminateByTagsstring[]
Optional list of tag names to use for strict matching when looking up existing users. If provided, all specified tags must match exactly for a user to be considered a match. For example, with an existing user whose tags are {"foo": "a", "bar": "b", baz: "c"}: Without this parameter, ALL tags must match exactly. With ["bar","baz"], all listed tags must match their values, and other tags are not considered.

Response

Returns a User object if a valid identifier was provided. 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.
metaobjectrequired