Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

...

General Information

...

ServiceAPIMethodData ModelsWorkflow
urac/joinPOSTUsersN/A

Description

This API allows guest to join (create an account).

Input

...

Type: application/json
NameSourceMandatoryTypeSpecial FormatDescription
usernameBodyYESString
  1. Alphanumeric
  2. Minimum Length: 5
  3. maxLength: 50
Username
passwordBodyYESStringN/APassword
emailBodyYESStringEmail formatEmail
firstNameBodyYESStringN/AFirst Name
lastNameBodyYESStringN/ALast Name
profileBodyNOObjectN/Aadditional information
membershipBodyNoStringfrom the membership object configuration (example: basic)checkout point #2 @ 04 Configuration Steps and requirements
lnBodyNoString
language "en", "fr"
phoneBodyNoString
Phone number


Output

...

Response

SOAJS has a unified response. Check out this link to understand more the schema of SOAJS response 

Valid Response

Code Block
languagejs
titleValid Response Sample
linenumberstrue
collapsetrue
{ 
  result: true,
  data:
   {
token: %token%,
     link:
      { join:
         'http://dashboard.soajs.org/#/join?token=%token%'
      }
   }	id: '%new_user_ID%'
}

Invalid Response

Code Block
languagejs
titleError Response Sample
linenumberstrue
collapsetrue
{
    "result":false,
    "errors":{
        "codes":[602],
        "details":[
            {
                "code":602,
                "message":"Model error: + %model_error%"
            }
        ]
    }
}

Response schema

Follow this link to check out the response JSON Schema

SOAJS Error Codes



Code
Description
400

Business logic required data are missing

524

Cannot join with a sub tenant key

602Model error: + %model_error%