Loading...

Authentication

Catalyst Authentication features enable you to add end-users to your Catalyst serverless applications, configure their user accounts and roles, and manage user sign-in and authentication of your application.

Add a New User

Description

This API enables you to add a new end-user to the Catalyst application for a specific platform. When the user has signed up, unique identification values such as ZUID, userID are created for them.

Note: You will be able to add only 25 users in your application in the development environment. After you deploy your application to production, you can include any number of end-users in it.

Request Details

Request URL

POST

{api-domain}/baas/v1/project/{project_id}/project-user/signup

copy

api-domain
URL
The DC-specific domain to access Catalyst API

project_id
Numerical
The unique ID of the project

Request Headers

Authorization: Zoho-oauthtoken {oauth_token}
Content-Type: application/json

Optional Headers

CATALYST-ORG: {org_id}

Environment: Development

Scope

ZohoCatalyst.projects.users.CREATE


Request JSON Properties

platform_type string
mandatory
Accepted values: web, android, ios
redirect_url string
optional
The URL to be redirected to, after the user signs up for the application
Max Size: 200
user_details json
mandatory

The JSON that contains the details of the user

first_name string
mandatory
First name of the user
Max Size: 100

last_name string
optional
Last name of the user
Max Size: 100

email_id string
mandatory
Email address of the user

Response Details

The response will contain the details of the user added in the data key, including the metadata and identification values such as zaid, user_id, and org_id that were generated.

Sample Request
copy

curl -X POST
https://api.catalyst.zoho.com/baas/v1/project/3000000002001/project-user/signup
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type: application/json”
-H “PROJECT_ID: 1010309726”
-d ‘{ “user_details”:{ “first_name”:“Rowena”, “last_name”:“Simmons”, “email_id”:“r.simmons@zylker.com” }, “platform_type”:“web”, “redirect_url”:“https://logistics.zylker.com/app/index.html" }’

Sample Response
copy
{
    "status": "success",
    "data": {
        "zaid": 1010309726,
        "user_details": {
            "user_id": 671930455,
            "user_type": "App Administrator",
            "zuid": 3000000006001,
            "zaaid": 1011520995,
            "status": "ACTIVE",
            "is_confirmed": true,
            "email_id": "r.simmons@zylker.com",
            "first_name": "Rowena",
            "last_name": "Simmons",
            "created_time": "May 13, 2019 09:16 PM",
            "modified_time": "May 13, 2019 09:16 PM",
            "invited_time": "May 13, 2019 09:16 PM",
            "role_details": {
                "role_id": 1256000000288012,
                "role_name": "App Administrator"
            }
        },
        "redirect_url": "https://logistics.zylker.com/app/index.html",
        "platform_type": "web",
        "org_id": 1011520995
        "locale": "us|en_us|America/Los_Angeles"
        "time_zone": "America/Los_Angeles"
    }
}