Configure additional user settings
Adds more information to the user, such as bio, notification settings, and email
Request
- Base URLhttps://www.spot.im/api
- URLhttps://www.spot.im/api/sso/v1/register-user
- Authnone declared. Required headers: Content-Type
Query parameters
Secret access token provide by OpenWeb
Session ID returned after initiating an SSO session
Non-unique personal identifier used prominently throughout the platform
A display name has the following characteristics:
- Cannot exceed 30 characters
- Is comprised of a combination of letters, numbers, special characters, or spaces
When not provided, OpenWeb creates a display name from the user_name.
If neither a username nor a display name is provided, the handshake will fail.
Unique user ID generated by a Partner’s backend user management system
Unique personal identifier used to differentiate between different users
A username has the following characteristics:
- Is greater than 3 characters, but less than 30 characters
- Can be comprised of foreign-language characters
- Cannot be comprised of delimiters, such as spaces, tabs, and other ASCII delimiters (/t, /r, and /n)
- Cannot be comprised of special characters, such as < and >
- Is preceded by the @ symbol when displayed
If a username is already taken, OpenWeb appends random letters or numbers to generate a unique version of that username and registers it to the user.
If a username is not provided, OpenWeb creates a username from the display_name, appends random letters or numbers to generate a unique version of that username, and registers it to the user.
If neither a username nor a display name is provided, the handshake will fail.
Email of the user
Indicates that the email of the user has been verified by the user
Possible Values:
- false (default)
- true
OpenWeb only sends email notifications to verified email addresses.
URL of the profile image of the user
This image is the avatar used for all comments created by the user. If the image_url is not set, OpenWeb selects a random avatar from the avatar scheme for the user.
To delete a set user image, send an empty string for this parameter.
Location of the user
Indicates whether the user's commenting history and profile can be viewed by others
Possible Values:
- false (default)
- true
Indicates if the user is a subscriber or not and enables the segmentation of data by subscribers and non-subscribers
If a user's subscriber status changes, you must <a href="https://developers.openweb.com/docs/implement-single-sign-on#log-out-a-user" target="_blank">log out the user</a> and complete a new SSO flow. This ensures that a user's previous cached client state for user_metadata.is_subscriber is not used.
Possible Values (values must be Base64-encoded):
{
"is_subscriber": true
}
When this value is passed for a user, you can also show a customized subscriber badge next to the user's name in the Conversation. Please contact Support to enable and customize the subscriber badge.
<hr />{
"is_subscriber": false
}
Headers
Enables sending a JSON body with the request
Request body
Response
Success response returned after OpenWeb logs in the user