POST /api/v1/users/find_or_create_by_provider
Find a user from external provider id

Params

Param name Description
provider
required

Provider name (google, apple, office365)

Validations:

  • Must be a String
uid
required

ID of the user given by provider

Validations:

  • Must be a String
email
optional , blank allowed

Validations:

  • Must be a String
mobile
optional , blank allowed

Validations:

  • Must be a String
origin_id
optional , blank allowed

ID in the previous database

Validations:

  • Must be a String
username
optional , blank allowed

username will be mandatory only if multiple users share same email

Validations:

  • Must be a String
encrypted_password
optional , blank allowed

Encrypted password in the previous database

Validations:

  • Must be a String
custom_pepper
optional , blank allowed

The pepper which have been used to encrypt the password

Validations:

  • Must be a String
google_id
optional , blank allowed

UID of a Google account linked to this user

Validations:

  • Must be a String
apple_id
optional , blank allowed

UID of an Apple account linked to this user

Validations:

  • Must be a String
email_confirmed
optional , blank allowed

Wether the user email have already been confirmed or not

Validations:

  • Must be one of: true, false, true, false.
given_name
optional , blank allowed

Validations:

  • Must be a String
family_name
optional , blank allowed

Validations:

  • Must be a String
non_latin_given_name
optional , blank allowed

Validations:

  • Must be a String
non_latin_family_name
optional , blank allowed

Validations:

  • Must be a String
male
optional , blank allowed

Gender: Wether the user is a male or female

Validations:

  • Must be one of: true, false, true, false.
birthdate
optional , blank allowed

Validations:

  • Must be a String
primary_country
optional , blank allowed

Alpha2 code of the country where the user do most of its Vipassana activity just give address country if you are not sure

Validations:

  • Must be a String
old_student
optional , blank allowed

Have the user already completed a 10day course?

Validations:

  • Must be one of: true, false, true, false.
is_at
optional , blank allowed

Is the user an assistant teacher?

Validations:

  • Must be one of: true, false, true, false.
at_code
optional , blank allowed

Assistant teacher code, for example AD5, YNP, NJ

Validations:

  • Must be a String
is_cct
optional , blank allowed

Is the user an children course teacher?

Validations:

  • Must be one of: true, false, true, false.
student_account_app
optional , blank allowed

Which student app should be used. If not provided, it will be automatically detected from primary_country

Validations:

  • Must be one of: mycourses, do_student_account.
password_required
optional , blank allowed

If the user is required to setup a password (otherwise they might only sign in with external providers such as google or office365)

Validations:

  • Must be one of: true, false, true, false.
require_mfa_from_date
optional , blank allowed

Date after which the user will have to set up MFA for her account. Format must be YYYY-MM-DD. Users are automatically emailed when a date is set and reminded one week before the date.

Validations:

  • Must be a String
office365_id
optional , blank allowed

UID of an Office365 account linked to this user. Can be updated only if the current value is blank.

Validations:

  • Must be a String
office365_email
optional , blank allowed

Office365 email of this user, something like [email protected]

Validations:

  • Must be a String

Returns

Code: 200

Description:

User object in JSON format (existing or newly created), with the keys: id, email, birthdate, given_name, family_name, non_latin_given_name, non_latin_family_name, primary_country, male, invited_to_url, username, old_student, office365_email, duplicates_ids, student_account_app, is_at, at_code, is_cct, mobile, confirmed, sign_up_complete, session_info, student_account_url, mfa_set_up

Param name Description

Code: 422

Description:

Validation errors when creating new user, in format: {error: {field_name: ["error message 1", "error message 2"]}}

Param name Description

Code: 401

Description:

Unauthorized - invalid or missing OAuth token

Param name Description