mndrAPI Docs

Getting Started

Overview of the MNDR public API for managing contacts and sequence enrollments.

The MNDR API lets you manage contacts and sequence enrollments from external systems — e-commerce platforms, CRMs, or any custom integration.

Base URL

All endpoints are prefixed with /api/v1:

https://your-domain.com/api/v1

Quick Start

  1. Generate an API key in Settings > Developer
  2. Include it in every request as the x-api-key header
  3. Start making requests
Example: upsert a contact
curl -X POST https://your-domain.com/api/v1/contacts/upsert \
  -H "x-api-key: mndr_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "jane@example.com",
  "firstName": "Jane"
}'

Resources

ResourceDescription
ContactsCreate, update, upsert, and manage contacts
SequencesTrigger sequences, enroll contacts, manage enrollments

Rate Limiting

The API allows 120 requests per minute per API key. Exceeding the limit returns 429 Too Many Requests with a Retry-After header.

Response Format

All responses are JSON.

Success
{
  "contact": {
    "id": "uuid",
    "email": "user@example.com",
    "firstName": "Jane"
  }
}
Error
{
  "error": "Contact not found."
}

Status Codes

CodeMeaning
200Success
201Created
202Accepted (async, e.g. trigger)
204Deleted (no content)
400Invalid request body or parameters
401Missing or invalid API key
404Resource not found
409Conflict (e.g. sequence not active)
429Rate limit exceeded

On this page