Email API

Add email marketing power to your software

Everything in the panel is in the API too: add subscribers, manage lists and segments, create, send and report on campaigns — all documented REST endpoints under /api/v1/.

Start free Swagger documentation

JWT authentication OpenAPI 3.0 schema HMAC-signed webhooks

CREATE AND SEND A CAMPAIGN

$ curl -X POST https://new.qulaq.com/api/v1/campaigns/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1…" \
  -d '{
    "name": "Mart Bülteni",
    "subject": "Bu ayın gelişmeleri",
    "sender_identity_id": "…",
    "template_id": "…",
    "list_ids": ["…"]
  }'

// then send with a single request:
$ curl -X POST …/api/v1/campaigns/{id}/send/

// response · 201 Created
{
  "data": { "status": "sending" },
  "meta": {}, "errors": []
}

Marketing endpoints

The whole flow, from subscriber to report

All requests use a Bearer token — get yours from /auth/login/.

POST /subscribers/bulk/

Creates subscribers in bulk. Single adds via /subscribers/, CSV import via /lists/{id}/import/.

POST /campaigns/{id}/send/

Sends the campaign immediately. Schedule with /schedule/, try first with /test/.

GET /campaigns/{id}/report/

Returns the campaign report: opens, clicks, bounces and complaints. Send logs via /campaigns/send-logs/.

GET /segments/{id}/preview/

Previews the subscribers matching a rule-based segment. Create segments with POST /segments/.

80+ endpoints including templates, providers, sender identities and verification: new.qulaq.com/api/v1/docs/

Webhooks

Let events come to you

Define webhooks for subscriber, campaign and email events: bounced or complaining addresses land in your system instantly, no polling needed.

12 events: subscriber.bounced, email.opened… SHA-256 HMAC signature — the X-Qulaq-Signature header 5 retries with exponential backoff Delivery logs: /webhooks/{id}/deliveries/

POST /webhooks/

{
  "url": "https://ornek.com/webhook",
  "events": [
    "subscriber.bounced",
    "subscriber.complained",
    "email.delivered"
  ],
  "is_active": true
}

// X-Qulaq-Signature: hmac_sha256(secret, body)

Same credits · panel + API

Make your first request today

Open your free account and grab your token. Your credits draw from the same balance in the panel and the API.

Start free See pricing

No credit card required Credits never expire

From the blog

Blog

July 12, 2026

Send your first campaign with the Qulaq API in 10 minutes

Grab a JWT, create a campaign, hit send: the foundation of marketing automation in three requests.

July 12, 2026

Real-time email events with webhooks

Stop polling for bounces and complaints. Push them straight into your system with HMAC-signed webhooks.

July 12, 2026

Real-time email verification on your signup form

Catch invalid addresses the moment someone signs up: integrating the verify API into your form.