Creating subusers via API

API credentials

1. Open the account menu.
   
2. Select Branding.
   
3. Note your dashboard subdomain located in the Personalize your application's URL field.
   
4. Note your App Secret Key. 
   
5. All API requests must be made to the API endpoint that includes your dashboard subdomain as the endpoint subdomain, with the app secret key submitted as the identifier parameter. 

Conventions

• All requests are made securely over HTTPS
• All requests are x-www-form-urlencoded 
• Each required parameter must be included in the request payload
• All responses are in JSON format
• Responses for each method are listed under the method
• Appropriate HTTP status codes will always be returned on success or error

API Endpoint

Host:      

.mywifi.io

Endpoint URL:        

https://.mywifi.io/api/

Request create-sub-user:

• Method: POST
• URL: /api/create-sub-user

Parameters: 

• identifier (string) [required] 
• first_name (string) [required]
• last_name (string) [required]
• mobile_phone (string) [required]
• email (string) [required]
• password (string) [required]
• quickreport (string: true/false) (optional)
• readonly (string: true/false) (optional)
• quickreport_location_id (integer) (optional)

phone_number:
The  phone_number format should be +CC(YYY)ZZZ-XXXX

email_address:
The  email_address must be formatted as a proper email address

password:
The password must be at least 5 characters in length

quickreport:
The  quickreport must be “true” or “false”

readonly:
The  readonly must be “true” or “false” 

quickreport_location_id:
The  quickreport_location_id must be a Location ID# from the MyWiFi Dashboard

Response:

Success

• Status: 200
• Response:
  {
  "status": "success",
  "message": "Sub User has been successfully created."
  }

Error

• Status: 400
• Response:
  {
  "status": "error",
      "message": {
          [error_msgs]
     }
  }