Grant access by email - MSAAQ Documentation

This endpoint is used to grant access to one or more courses or products to a member using their email.

✅ Behavior

If the user does not exist, a new member will be created using the provided email and optional fields.

If the user already exists, the system will simply grant access to the specified courses/products.

If password is null, the user can log in via OTP or SSO (if your system supports it).

No duplicate access will be created if the user already has access to a product.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

string

required

Example:

application/json

X-Tenant

string

required

Example:

Body Params application/json

string

required

The member email address. If the user does not exist, an account will be created.

Example:

name@example.com

products

array [object {2}]

required

Array of access objects containing id and type. Each object represents a course or product to grant access to.

string

required

The ID of the course or product to grant access to.

type

enum<string>

required

Type of the item: course or product. Use course for any course or learning path, and product for digital products like downloads, bundles, coaching, etc.

Allowed values:

courseproduct

first_name

string | null

optional

First name of the member.

last_name

string | null

optional

Last name of the member.

password

string | null

optional

Optional password for the account. If null, the member will log in using OTP or SSO (if configured).

phone_code

string | null

optional

International dialing code (e.g., +966).

phone

string | null

optional

Phone number of the member.

with_auth_url

boolean

optional

If set to true, the response will include a passwordless login URL for the member.

Example

{
  "email": "name@example.com",
  "products": [
    {
      "id": "12343",
      "type": "product"
    },
    {
      "id": "423234",
      "type": "course"
    }
  ],
  "first_name": "Alex",
  "last_name": "Towne",
  "password": null,
  "phone_code": "966",
  "phone": "575315110",
  "with_auth_url": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

message

object (SuccessResponseMessage)

required

title

string | null

optional

body

string

required

data

object

required

new_account_created

boolean

required

Indicates if the account was newly created (true) or already existed (false)

granted_access_count

integer

required

Number of courses/products access was successfully granted to.

auth_url

string | null

optional

Only present if with_auth_url is true. A passwordless login link for the member.

member

object (MemberResource)

required

Example

{
  "message": {
    "body": "تمّ منح المتدرب الوصول المطلوب."
  },
  "data": {
    "new_account_created": false,
    "granted_access_count": 0,
    "auth_url": "https://academy.example.com/passwordless?url=https%3A%2F%2Fmsaaq.test%2Fv1%2Ftenant%2Fauth%2Fpasswordless%3Facademy_id%3D1%26expires%3D1742907118%26user_id%3D551149%26signature%3D841aafd123cd6d54595d4e6bf454fe605e3768643ed02c7ba2e6c7d308899081&success_redirect_url=%2F",
    "member": {
      "id": 551149,
      "first_name": "Alex",
      "last_name": "Towne",
      "name": "Alex Towne",
      "english_name": null,
      "username": "52a9ba7b-9f3e-4adc-8aea-8e304046cee6",
      "avatar": null,
      "points": 0,
      "bio": null,
      "job_title": null,
      "education": null,
      "url": "https://msaaqacademy.test/@52a9ba7b-9f3e-4adc-8aea-8e304046cee6",
      "courses_count": null,
      "products_count": null,
      "total_purchases": null,
      "orders_count": null,
      "national_id": null,
      "country_code": null,
      "currency": "",
      "gender": null,
      "skills": null,
      "email": "name@example.com",
      "phone_code": 966,
      "phone": 575315110,
      "international_phone": "966575315110",
      "dob": null,
      "email_verified_at": null,
      "phone_verified_at": null,
      "is_verified": false,
      "status": "active",
      "newsletter_status": "subscribed",
      "newsletter_subscribed_at": "2024-07-18 16:10:45",
      "newsletter_unsubscribed_at": null,
      "balance": "0.00",
      "last_seen_at": null,
      "updated_at": "2025-03-25 15:14:39",
      "created_at": "2025-03-25 15:14:39",
      "meta": null
    }
  }
}