MSAAQ Documentation
Docs
APIs
  • Admin
  • Tenant
Docs
APIs
  • Admin
  • Tenant
Status
  1. Docs
  • Getting Started
  • Integration Guides
    • Google Tag Manager (GTM)
  • APIs
    • OAuth
      • Ping
      • Craete Token
      • Craete Token - From Accounts
    • Admin
      • Auth
        • Register
        • Login
        • Me
        • Logout
        • change-password
        • change-email
        • update
        • permissions
        • Email verification
        • Refresh Token
        • accept Invitation
        • Reset Password
        • Forget Password
        • Passwordless
        • Phone Verification
      • Teams
        • Users
          • Send reset password email
          • Send verification email
          • Delete User
          • Update User
          • instructors
          • list
          • Craete User
        • Permissions
          • list
        • Roles
          • Get Role Permissions
          • Delete Role
          • Update Role
          • Get Role
          • Create
          • list
      • Academies
        • Join Beta
        • Create
        • list
      • Dashboards
        • Main
          • Sales By Country
          • Best sales
          • Sales Per Month
          • Stats
        • MSAAQPay
          • Best sales
          • Stats
        • Reports
          • Customers
            • export
            • Customers/members Country
            • Customers/most Orders
            • Customers/stats
            • Customers/chart
          • Analytics
            • export
            • Analytics/top Referrers
            • Analytics/most Visited Pages
            • Analytics/session devices
            • Analytics/session countries
            • Analytics/stats
            • google analytics scopes
            • get google analytics access token
          • Orders
            • export
            • top-sources
            • top-days
            • sells-chart
            • chart
            • stats
          • Products
            • Products
            • Courses
            • export
            • Top Selling
          • Campaigns
            • export
            • stats
      • Members
        • Segments
          • export
          • delete
          • update
          • create
          • show
          • list
          • grant access segment
        • Access
          • Grant Member Access
          • Remove Member Access
          • Grant access by email
          • Remove access by email
        • Delete Member
        • Update Member
        • Get Member
        • sendResetLinkEmail
        • Create
        • export
        • import
        • List Members
        • Unsubscribe from newsletter
        • subscribe from newsletter
        • Get Member by Email
      • Courses
        • Chapters
          • Contents
            • Create
              • Create zoom meetig
              • Create meeting
              • Create text
              • Create survey
              • Create embed
              • Create PDF
              • Create audio
              • Create Assignment
              • Create Video
              • Create Quiz
              • Create Interactive element
              • Create Interactive question
            • Update
              • Publish Quiz
              • Update Quiz
              • Archive Quiz
              • Update Interactive element
              • Update Interactive question
              • Update meeting
              • Update Survey
              • Update embed
              • Update assignment
              • Update video
            • replicate content
            • delete content
            • Show Content
            • List Content
          • Drip
          • Sort
          • Delete
          • Update
          • Create
          • Get chapter
          • List Chapters
        • Get Course Attendance
        • Replicate course
        • Delete Course
        • Update Course
        • Create Course
        • Get Course stats
        • Get Course
        • Export Courses
        • List Courses
      • Videos
        • Delete Video
        • Update Video
        • Get Video Uesage
        • Get Video
        • Create
        • list
      • Quizzes
        • Question
          • Create Questions
          • Delete question
          • Sort Question
          • Replicate Question
          • Update Question
          • Get single question
          • List of questions
        • export Quiz Members
        • export
        • Get Survey members
        • Get Quiz members
        • Delete Quiz
        • Update Quiz
        • Get Quiz
        • Create
        • list attempts
        • Show Quiz
        • List Quizzes
      • Taxonomies
        • Delete Category
        • Update Category
        • Get Category usage
        • Get Category
        • Create
        • list
      • Builder
        • Pages
          • Delete Page
          • Replicate Page
          • Update Page
          • Get Page
          • Create
          • list
        • Blocks
          • list
        • Menus
          • Menu options
          • deleteLink
          • show
          • save
          • list
        • update
        • options
      • Enrollments
        • export
        • List Enrollments
      • Dowloads
        • export
        • Remove Tenant
      • Tags
        • Export Tags
      • Currencies
        • list
      • Countries
        • list
      • Certificates
        • list certificates
        • previiew
        • Delete
        • create
      • Certificates Templates
        • replicate
        • Delete
        • Update certificate
        • create
        • Get single
        • list
      • Appointments
        • cancel
        • list
      • Difficulties
        • Delete Difficulty
        • Update Difficulty
        • Get Difficulty
        • Create
        • list
      • Assigment Members
        • Update assignment member
        • Get assignment member
        • export
        • List
      • Assignments
        • List Assignment Segments
        • Get assignment
        • list
      • Products
        • (deprecated) check google calendar
        • Replicate
        • Delete product
        • Update product
        • Get product stats
        • Get product
        • Create
        • export
        • downloads export
        • downloads
        • list
        • Get product
      • Articles
        • Delete article
        • Upload editor media
        • Update article
        • duplicate article
        • Get article
        • Create
        • export
        • list
      • Webhooks
        • Delete Webhook By URL
        • Delete Webhook
        • Update Webhook
        • Create Webhook
        • Show Webhook
        • List Webhooks
      • Domains
        • DNS
          • Delete
          • Update
          • Create
          • list
        • domains/delete
        • domains/verify-activation
        • domains/make-default
        • domains/create
        • domains/show
        • domain/list
      • Comments
        • Reply
          • List Comment Replies
        • Like
        • Reply
        • Show Comment
        • Update Comment
        • Delete comment
        • Get comment
        • list
      • Reviews
        • Delete comment
        • reply
        • Update review
        • Get review
        • list
      • Orders
        • Get order invoice
        • Get order
        • export
        • list
      • Cancellation Reasons
        • list
      • Bank Transfers
        • update
        • Get bank transfer
        • list
      • Coupons
        • Delete coupon
        • Update coupon
        • Get coupon
        • Create Coupon
        • coupon stats
        • export uses
        • list of uses
        • list
        • export coupon uses
      • Campaigns
        • Delete campaign
        • Update campaign
        • Send test campaign
        • Preview campaign
        • Get campaign sends
        • Get campaign
        • Export campaigns
        • Create campaign
        • estimate-message-volume
        • list campaigns
        • grant 100 free emails
        • Replicate campaign
        • Export campaign
        • Export campaign sends
      • Affiliates
        • Get Settings
        • Setting
        • update paypout
        • Get payout
        • Payout list
      • Msaaq Affiliates
        • Payouts
          • Payout
          • payout receipt
          • payout show
          • payouts list
        • Get Info
      • Settings
        • Academy Email Domain
          • Store email domain
          • Get email domains
          • Update email domain
          • Delete email domain
        • Tenant Email Domain
        • {{baseUrl}}/admin/settings
        • {{baseUrl}}/settings/translations
        • supported languages
        • translations
        • Customize registeration form
        • Update settigs
        • Update translations
      • MsaaqPay
        • Transactions
          • refund
          • Invoice
          • Get transaction
          • export
          • List Transactions
        • Payouts
          • Receipt
          • Get payout
          • Create payout
          • Setting
          • list
        • Settlement
          • Var Invoice
          • Report
          • Receit
          • Get settlemtn details
          • list
        • setting
        • setting
      • Apps Marketplace
        • Get analytics properties list
        • Get convertkit lists
        • Get mailchimp lists
        • uninstall app
        • Install app
        • callback
        • Show
        • List
      • Academy Verification
        • Nelc License
          • Get nelc products
          • Nelc License Checkout
        • Acccept msaaqpay contract
        • Entity msaaqpay contract
        • Get entity
        • Wathq check
        • Status
        • Start verify
      • Billing
        • Subscription
          • Validate Promo Code
          • Swap
          • Unpause
          • Addon Subscribe
          • Subscribe
          • Pause
          • subscription
        • SMS
          • purchase
          • Settings
          • Bundles
        • Strip
          • Cards
            • Mark As default
            • Create Card
            • Delete card
            • List
          • Subscriptions
            • Swap
            • Resume
            • Cancel
            • Create
            • Get
            • List
          • setup-intent
        • Emails Plans
        • plans
        • receipts
      • Notifications
        • Update Mail Template
        • Upadte Settings
        • markARead
        • List
        • Settings
      • Apps
        • Salla
          • Get product
          • products
      • Search
        • search
      • Abandoned Carts
        • destroy reminder
        • show reminder
        • update reminder
        • custom reminder
        • store reminder
        • reminders
        • export
        • stats
        • list
      • Announcements
        • announcements
        • mark as read
      • Onboarding
        • Onboarding Questionnaire
          • questions/answers
          • questions
        • Onboarding Checklist
          • mark as completed
          • onboarding checklist
        • onboarding
        • mark as read
      • Forms
        • Create | Update Form
        • Show Form
      • Bank
        • Update
        • Get currenent user bank
        • Create
      • Coaching sessions
        • check google calendar
        • Replicate
        • Delete
        • Update
        • Get stats
        • Details
        • Create
        • downloads
        • List
        • export
        • download export
      • Learning Paths
        • Course
          • Sync Learning Path Courses
          • List Learning Path Courses
        • List learning paths
    • Tenant
      • Getting Started with Tenant API
      • Auth
        • Me
        • Logout
        • Passwordless
        • Reset Password
        • Forget Password
        • Validate-recaptcha
        • Authorize Verify
        • Authorize
        • Register
        • Email Verify
      • Reviews
        • Delete Review
        • Update Review
        • Create Review
        • Reviews distribution
        • List Reviews
      • Account
        • Update login credentials
          • Change password
          • verify
          • Update login credentials
        • Affliates
          • Withdraw Request
          • payouts
          • Info
        • Banks
          • Remove Bank Acount
          • Update Bank Account
          • Create Bank
          • Show bank
        • Calendar
          • Calendar
        • Change password by signed
        • Unsubsribe
        • Update Account
        • Get order invoice
        • Last viewed course/learning path
        • List User's Appointments
        • User Stats
        • List User's Rejected Assignments
        • List User's Assignments
        • List User's Quizzes
        • List User's Upcomming Appointments
        • List User's Products
        • List User's Courses
        • List User's Learning Paths
        • Last User's Orders
      • Certificates
        • Verify Certificate
        • Download Certificate
        • List User's Certificates
      • Currencies
        • List of currencies
      • Newsletter
        • Unsubscribe
        • Subscribe
        • Request subscribe
      • Cart
        • Checkout
        • Redeem Coupon
        • Express Checkout
        • Remove From Cart
        • Add To Cart
        • Get cart by uuid
        • Get Current Cart
        • Get card token
      • Courses
        • Overview
        • Chapters
          • Contents
            • Comments
              • Create Comment's Reply
              • Delete Comment
              • Update Comment
              • Create Comment
              • List Comments
            • Quizzes
              • Close Attempt
              • Submit Survey Answer
              • Submit Quiz Answer
              • Survey Attempt Details
              • Quiz Attempt Details
              • Attempt Survey
              • Attempt Quiz
            • Assignments
              • Resubmit Assignment
              • Submit Assignment
            • Mark Content as Complete
            • Join meeting
            • Content Attachmet Dowload
            • Content Details
            • List Chapter's Contents
          • Chapter Details
          • List Chapters
        • Get QR code
        • Course Details
        • Course Certificate
        • List Best Selling Courses
        • List Interesting Courses
        • List Courses
      • Payments
        • Tap callback
      • Pages
        • Contact Us
        • Page Details
        • Privacy Page
        • About Us
        • Terms Page
        • Home Page Details
      • Articles
        • Comments
          • Create replay
          • Delete Comment
          • Update Comment
          • Create comment
          • List of comments
        • Article Details
        • List of Articles
      • Instructors
        • Instructor Details
        • List of Instructors
      • Taxonomies
        • Get Taxonomy details
        • List of Taxonomies
      • Products
        • Interesting Products
        • Interesting Products
        • Download Product media
        • Available Appointments
        • Product Details
        • Best sales products
        • List Products
      • Appointments
        • book appointment
        • show Appointments Details
        • List Appointments
      • Comment
        • List Comment Replies
      • Learning paths
        • Learning path Details
      • notifications
        • list
        • mark as read
      • Assignment
        • List Assignment Segments
      • Get Sitemap
      • Get Translations
      • Search
      • Well Know
      • Ping Pong
      • Get Tenant Details
    • Assignment
  1. Docs

Getting Started

This guide will get you all set up and ready to use Msaaq APIs. We'll cover different APIs and how to authenticate requests as well as making your first API request.

Terminology#

Before we get started, let's define some terms that you'll come across when working with Msaaq APIs:
Dashboard: The Dashboard is a web application that allows you to manage your Msaaq account, create and manage Tenants, and more.
Dashboard User: A person who uses the Dashboard. Users can be part of one or more Tenants and can have different roles in each Tenant (Owner, Administrator, Instructor, Marketer, etc.).
Tenant: An isolated instance of Msaaq. Each tenant has its own Tenant Users, courses, digital products, consulting sessions, and more.
Tenant User: A person who uses a specific Tenant. Tenant Users are usually referred to as Students. They can be added by Dashboard Users or by signing up via the Tenantfront or the Authentication API in the Tenant API.
Tenantfront: The default frontend of every Tenant. It's where Tenant Users can purchase and access courses, digital products, consulting sessions, and more. The Tenantfront is usually accessible at https://{tenant_slug}.msaaq.net or by its custom domain if it has one set up in the Dashboard.

APIs Overview#

Msaaq has two main APIs, the Dashboard API and the Tenant API.
Dashboard API (aka. Admin API): Used to serve and manage Msaaq Users and Tenants' actions and operations, managing Tenants includes content management, Tenant Users management (Adding, Updating, Gifting products, etc.) as well as Payment Gateways and everything else related to configuring Tenants. Basically everything that you can see/do when you visit the Dashboard. This API is also known as the Admin API.
Tenant API: Used to serve the Tenantfront actions and operations, including Tenant User authentication, making payments, retrieving courses, digital products, consulting sessions, bundles, and everything else related to a tenant. There are no roles in the Tenant API, all requests are made on behalf of the visitors or the Tenant Users.

API Base URL#

The base URL for the Msaaq API is https://api.msaaq.com/v1. While all API requests should be made to this URL, each API has its own path that you should append to the base URL.

API Paths#

Dashboard API: All requests to the Dashboard API should be made to the /admin path (e.g., https://api.msaaq.com/v1/admin/courses).
Tenant API: All requests to the Tenant API should be made to the /tenant path (e.g., https://api.msaaq.com/v1/tenant/courses).

Authentication#

Before making your first API request, you should authenticate your requests. You can authenticate your requests using an API access token. You can obtain an access token through our OAuth 2.0 flow.

OAuth 2.0 flow#

The OAuth 2.0 flow requires you to send a POST request to the /v1/oauth/token endpoint with your client ID and client secret. The response will include an access token that you can use to authenticate your requests.
Notice that the OAuth endpoint is not part of any of the APIs, it's a standalone endpoint that you can use to obtain an access token, which you can then use to authenticate your requests to any of the APIs.
Make sure that your plan includes API access and that you've obtained a client ID and a client secret. You can contact us if you need to obtain these credentials. You can check if your plan includes API access through your subscription details page in the Dashboard.
Warning
Your client ID and client secret should be kept confidential. Do not expose them in public repositories or client-side code/requests. If you suspect that your client ID and/or client secret have been compromised, contact us immediately to revoke them.

Request#

cURL
JavaScript
Python
PHP
OAuth Request Body
client_id
string 
required
The client ID of the OAuth2 application.
client_secret
string 
required
The client secret of the OAuth2 application.

Response#

200
401
{
  "status": "success",
  "code": "200",
  "data": {
    "token_type": "Bearer",
    "expires_in": 31536000,
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUz..."
  }
}
OAuth Response Body
status
enum<string> 
required
The status of the response.
Allowed values:
successfailed
code
string 
required
data
object 
required
The data object containing the token information.
token_type
enum<string> 
required
The type of token provided.
Allowed value:
Bearer
expires_in
integer 
required
The time in seconds before the token expires.
access_token
string 
required
The access token to be used for authentication.

Making your first API request#

Now that you have a valid access token, you can make your first API request. Below, you can see how to send a GET request to the Ping endpoint. If everything is done right, you'll get a simple Pong response.
Tip
When interacting with the APIs, we recommend setting the Accept header to application/json to ensure that you always receive JSON responses.

Request#

cURL
JavaScript
Python
PHP

Response#

200
401
{
    "message": "pong!"
}

What's next?#

Great, you're now set up with an API client and have made your first request to the API. Here are a few links that might be handy as you venture further into the MSAAQ API:
Grab your API key from the MSAAQ dashboard
Check out the MSAAQ endpoint
Learn about the different error messages in MSAAQ
Next
Google Tag Manager (GTM)
Built with