Create a User

POST /users

Create a new user.

Attributes

email string Required
Valid email address of the user.
type string Required
Type of the user, can be Attendee or Speaker.
firstName string Required
First name of the user.
lastName string Required
Last name of the user.
username string

Username of the user. If none if defined, one will be automatically be created with a sanitized combination of the last name, the first name and a random 4 digit number.

Sample generated username: doe.jane#0000.

avatar string

Image URL for user's avatar. Image file must be publicly accessible and use the https protocol.

description string
Description of the user.
job string
Job title of the user.
company string
Company the user is working for.
tags array of string
Tags that should be attached to the user. Listed tags that do not already exist will be created automatically.
timezone string
Timezone of the user, used to send emails and reminders with dates and times formated to user's timezone.
country string
Country of the user.
city string
City of the user.
status string
Professional situation of the user, allows only the following values:
  • Employed
  • Looking for a job
  • Student
  • Freelancer
  • Working for a startup
website string

Website of the user, the URL must use the https protocol.

socials object

Social networks links of the user, URLs must use the https protocol.

socials attributes
socials.facebook string
Link to user's Facebook profile.
socials.linkedin string
Link to user's LinkedIn profile.
socials.twitter string
Link to user's Twitter profile.
socials.youtube string
Link to user's YouTube channel.
options object

Options relative to the user creation.

options attributes
options.highlight boolean, default false
Only supported for user of type Speaker, define if the user can be highlighted with the filter of the same name in the Speakers page.
options.endRegistration boolean, default false
Indicate if the user will have to review their information before completing the registration at their first connection to the platform. Set to true to skip the review.

Sample request body 

{
  "email": "speaker-email@domain.com",
  "type": "Speaker",
  "firstName": "Jane",
  "lastName": "Doe",
  "username": "SuperJane",
  "avatar": "https://domain.com/image-link.jpg",
  "job": "Tester",
  "company": "Comp Limited",
  "tags": ["Mentor", "Host"],
  "timezone": "Europe/Paris",
  "country": "France",
  "city": "Paris",
  "status": "Employed",
  "website": "https://jane-doe.com",
  "socials": {
    "facebook": "https://www.facebook.com/jane.doe",
    "linkedin": "https://www.linkedin.com/in/janedoe/",
    "twitter": "https://twitter.com/janedoe",
    "youtube": "https://www.youtube.com/@janedoe"
  },
  "options": {
    "highlight": false,
    "endRegistration": false
  }
}

Returns

If all provided data are valid and the user is created with success the response will return the following attributes, otherwise it will return an error.

code string
message string
id string
Unique identifier of the created user.
email string
Email address of the user.
password string

A password is automatically generated following the platform password settings and is to send to the user. We highly recommend asking the user to change their password when they first connect to the platform.

Users password are stored securely as decribed in our Password policiy

Warning

The password should not be stored and is only returned so you can send it to the speaker.

sideErrors array of object

If some, list of non blocking errors that occured after user creation.

sideErrors attributes
sideErrors.message string
Side error message
sideErrors.error string
Error details

Sample response 

{
  "code": "ok",
  "message": "User created successfully",
  "id": "6627cb4d6f1f3e2d6cf414bb",
  "email": "speaker-email@domain.com",
  "password": "********************",
  sideErrors: []
}