Skip to content


When you or a user starts your app/script/etc, they will be required to login using the endpoint. The LOGIN will provide a User JSON Web Token (JWT) that will be required for user-related API calls.

POST /auth

To retrieve your JWT/Login, send a request with your email and password.

Name Type Required Description
Content-Type String Yes Must be application/json
Name Type Required Description
email String Yes Email address
password String Yes Login password
curl -H 'Content-Type: application/json' -s -X POST -d '{"email": "$EMAIL_ADDRESS", "password": "$PASSWORD"}'


  • $EMAIL_ADDRESS is the email address associated with your MASV account
  • $PASSWORD is the password associated with your MASV account

If you successfully authenticate, this endpoint will return an HTTP response with a status code of 200 OK and a body similar to the as the one below.

  "teams ": [
      "id ": "01D377KWTJDPC8JQC6XVGPMHDW ",
      "name ": "Default Team ",
      "subdomain ": "a8fc91fa "
  "token ": "eyJhbGciOiJIUcI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1NTQ0MDUzNjQsImV4dCI6e30sImltcCI6ZmFsc2UsInN1YiI6IjAxRDM5OEtXTjlBWEI3NkgyRUZONFcwOVFIIn0.DlqkZSTg68wQ9bjkZlcYigvb41owmPlRK2KJloiGUUw ",
  "user ": {
    "email ": "[email protected] ",
    "id ": "01D398ZWSXWS8YBZKXCW56BF4H ",
    "level ": "basic ",
    "name ": "MASV API ",
    "time_zone ": "EST"


  • teams is an array of all teams the logged-in user belongs to
  • token is the auth token that is required for all user-related API calls. The token must be passed as a header value named X-User-Token with every request that requires a user token.
  • user is the logged in user info