Note
Note
MONDAi's API is the GoHighLevel API. Full documentation is available at highlevel.stoplight.io. This article covers getting started with your API key in the context of MONDAi.
The MONDAi API lets you read and write data programmatically: create contacts, update pipelines, trigger workflows, retrieve appointment data, and more. Use it when you need a custom integration that Zapier or Make does not cover, or when you are building a bespoke tool on top of MONDAi data.
Authentication
Get your API key from Settings → API → API Keys. Click Generate Key if none exists. All API requests require this key in the request header:
Authorization: Bearer YOUR_API_KEY
Your Location ID is also required for most endpoints. Find it at Settings → Business Info → Location ID.
Key Endpoints
Get contacts: GET /contacts/ — returns your contact list with filter support by tag, date, or custom field.
Create/update contact: POST /contacts/ — creates a new contact or updates an existing one if the email matches.
Add tag: POST /contacts/{id}/tags/ — applies one or more tags to a contact.
Get appointments: GET /appointments/ — returns appointment data for a date range.
Trigger workflow: POST /contacts/{id}/workflow/{workflowId} — manually triggers a workflow for a contact.
- Hardcoding the API key in client-side code. Your API key grants full account access. Never expose it in browser-side JavaScript.
- Not handling rate limits. The API enforces rate limits. Implement exponential backoff for bulk operations.
- Using the wrong base URL. The API base URL is specific to your account region. Confirm the correct base URL from Settings → API.
Still stuck?
- Search the MONDAi Help Center
- Email support@mondai.io with a Loom video
- Ask inside the ArchiTech Channel
Press ⌘K to search every article, or email support@mondai.io.