MONDAi API Guide: Getting Started

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.

Common Mistakes

• 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.