Overview
The Mobaro API allows you to securely access and interact with your Mobaro environment. Whether you're building dashboards, automating assignments, or connecting to third-party tools, the API gives you programmatic access to Results, Users, Assignments, Locations, Assets, and more.
It’s designed using REST principles and communicates over HTTPS using JSON. With a valid API key, you can:
Export checklist results for analysis or compliance
Sync users or assets with external HR/CMMS systems
Trigger workflows based on checklist responses
Connect Mobaro to reporting tools like Power BI or Google Sheets
Tip: Mobaro is also available as a connector in Microsoft Power Automate. For many use cases, no-code automation is possible without direct API calls.
Authenticate with your API key
All requests to the Mobaro API must include an x-api-key header.
Header format:
x-api-key: YOUR_SECRET_TOKEN
Make sure to keep your API key secure. If your key is lost or compromised, contact Mobaro Support to generate a new one.
Headers and content type
Depending on your request method, you may need to include the appropriate headers:
GET requests:
No content type is required.
POST/PUT requests with a JSON body:
Content-Type: application/json
Full header example:
--header 'Content-Type: application/json'
--header 'X-Api-Key: YOUR_SECRET_TOKEN'
Endpoint examples
Retrieve all timesheet entries
GET /api/customers/timesheets
Example using curl:
curl https://app.mobaro.com/api/customers/timesheets \
--header 'X-Api-Key: YOUR_SECRET_TOKEN'
Create a timesheet entry
POST /api/customers/timesheets
Example using curl:
curl https://app.mobaro.com/api/customers/timesheets \
--request POST \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: YOUR_SECRET_TOKEN' \
--data '{
"description": null,
"user": "",
"origin": null,
"type": null,
"started": "",
"stopped": null
}'
Use Mobaro with Power Automate
Mobaro is available as a connector within Microsoft Power Automate. You can:
Trigger flows based on submitted checklist results
Send Mobaro data to Excel, SharePoint, or external APIs
Schedule regular reports or exports using Mobaro endpoints
Best practices
Never expose your API key in public-facing tools.
Use filtering and pagination to manage large datasets efficiently.
Test your API calls with Postman or curl before integrating into larger workflows.
Handle errors and retry logic in your scripts, especially for 429 or 503 errors.
Frequently asked questions
Q: How can I get access to my API key?
A: API keys can be found by going to Configuration > API keys in the Mobaro backend. If you don’t have access to this section, please contact one of your local administrators. For security reasons, Mobaro Support cannot issue or retrieve API keys.
Q: Can I filter data by date or location?
A: Yes. Most endpoints allow filters like AnsweredBefore, AnsweredAfter, or LocationIds. Refer to the API documentation for full query parameter support.
Q: What should I do if I get a 401 error?
A: Check that your x-api-key header is correct and active. A 401 error indicates missing or invalid authentication.
Q: Do I need to include Content-Type for all requests?
A: Only include it for requests that include a JSON body (typically POST/PUT). It’s not required for GET requests.
Q: Can I use the API to update checklists or change the platform configuration?
A: No. The API is intended for accessing and pushing data, not for modifying checklists or system configuration.