The Email with OTP authentication allows your client to authenticate using OTP method. The endpoints are pre-built and are easy to manage your authentication flow and users. To get your {auth_base_url}, check it out here - Get started with base url.

Note : APP-KEY to be passed in Headers can be obtained from the settings in the project dashboard

Sending Email OTP - Currently, we don’t support additional custom SMTP configuration. We send emails from our SMTP server. No configuration is needed for email setup

1. Signup API

This endpoints allows you to create a new user using the email address and otp method.

POST
{auth_base_url}/email-otp-signup

Example

Request
POST https://authn.zeromagic.cloud/auth/353d1499ab5149e194a53cf0f6c837f4/development/email-otp-signup 
HTTP/1.1
APP-KEY : ldM6yPAAE3PRTZbHXrjqGGzZY2Yjm7GwjAyjbNqWH48

{
    "email":"user@zeromagic.cloud"
}
Response
HTTP/1.1 
201 CREATED

{
    "user_id": "1",
    "email":"user@zeromagic.cloud"
}

2. Login API

This endpoints allows you to login a user using the email and otp method.

Example

Request
POST https://authn.zeromagic.cloud/auth/353d1499ab5149e194a53cf0f6c837f4/development/email-otp-login 
HTTP/1.1
APP-KEY : ldM6yPAAE3PRTZbHXrjqGGzZY2Yjm7GwjAyjbNqWH48

{
    "email":"user@zeromagic.cloud"
}
Response
HTTP/1.1 
200 OK

{
    "user_id": "1",
    "email":"user@zeromagic.cloud"
}

3. Verify OTP API

This endpoints allows you to verify the otp of the respective email address.

Example

Request
POST https://authn.zeromagic.cloud/auth/353d1499ab5149e194a53cf0f6c837f4/development/email-otp-login 
HTTP/1.1
APP-KEY : ldM6yPAAE3PRTZbHXrjqGGzZY2Yjm7GwjAyjbNqWH48

{
    "email":"user@zeromagic.cloud"
    "otp_code" : 1234
}
Response
HTTP/1.1 
200 OK

{
   "user_id": "1",
   "email":"user@zeromagic.cloud"
   "access_token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MTIzNDU2Nzg5LCJuYW1lIjoiSm9zZXBoIn0.OpOSSw7e485LOP5PrzScxHb7SR6sAOMRckfFwi4rp7o",
   "token_type" :"bearer",
   "expires_in" : null
}