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

Body Params application/json

Example

{
    "email": "info@msaaq.com",
    "products": [
        {
            "id": "114",
            "type": "course"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

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
        }
    }
}