Complete guide to integrating GQ CRM | Marketing Mail into your application
Welcome to the GQ CRM | Marketing Mail API. This guide will help you integrate our email service into your application.
The GQ CRM | Marketing Mail API is a simple JSON-over-HTTPS API. You send emails through your own SMTP configuration, while we handle delivery, open and click tracking (plan-dependent), and sending logs. Requests are authenticated with an API key in the X-API-Key header — a project key for sending and a workspace key for the Contacts API — and each response follows a consistent format:
// Success
{ "success": true, "data": { ... }, "message": "..." }
// Error
{ "success": false, "error": "human-readable reason", "data": { ...optional } }https://gq-crm.com/api| Method | Path | Description |
|---|---|---|
| POST | /api/send | Send one or more emails (single recipient, array, or template-based) |
| GET | /api/health | Service health check |
| GET | /api/contacts | List/search contacts with incremental sync (workspace key, contacts:read) |
| POST / PATCH / DELETE | /api/contacts, /api/contacts/[id] | Create, update and delete contacts (workspace key, contacts:write) |
| POST | /api/contacts/[id]/send | Send an email to one contact (project key, send:email) |
Verify the API is reachable before integrating:
{
"status": "healthy",
"timestamp": "2026-08-01T10:00:00.000Z",
"service": "marketing-mail"
}