Email API

Aggiungi la potenza dell'email marketing al tuo software

Tutto ciò che è nel pannello è anche nell'API: aggiungi iscritti, gestisci liste e segmenti, crea, invia e analizza campagne — tutti endpoint REST documentati sotto /api/v1/.

Inizia gratis Documentazione Swagger

Autenticazione JWT Schema OpenAPI 3.0 Webhook firmati HMAC

CREA E INVIA UNA CAMPAGNA

$ 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": ["…"]
  }'

// poi invia con una sola richiesta:
$ curl -X POST …/api/v1/campaigns/{id}/send/

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

Endpoint di marketing

Tutto il flusso, dall'iscritto al report

Tutte le richieste usano un token Bearer — il tuo si ottiene da /auth/login/.

POST /subscribers/bulk/

Crea iscritti in bulk. Aggiunta singola via /subscribers/, import CSV via /lists/{id}/import/.

POST /campaigns/{id}/send/

Invia subito la campagna. Pianifica con /schedule/, prova prima con /test/.

GET /campaigns/{id}/report/

Restituisce il report della campagna: aperture, clic, bounce e reclami. Log di invio via /campaigns/send-logs/.

GET /segments/{id}/preview/

Anteprima degli iscritti che corrispondono a un segmento a regole. Creazione segmenti: POST /segments/.

80+ endpoint inclusi template, provider, identità mittente e verifica: new.qulaq.com/api/v1/docs/

Webhook

Gli eventi arrivano da te

Definisci webhook per eventi di iscritti, campagne ed email: gli indirizzi che rimbalzano o reclamano arrivano subito nel tuo sistema, senza polling.

12 eventi: subscriber.bounced, email.opened… Firma HMAC SHA-256 — header X-Qulaq-Signature 5 tentativi con exponential backoff Log di consegna: /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)

Stessi crediti · pannello + API

Fai la tua prima richiesta oggi

Apri il tuo account gratuito e prendi il token. I crediti attingono allo stesso saldo nel pannello e nell'API.

Inizia gratis Vedi i prezzi

Nessuna carta di credito I crediti non scadono

Dal blog

Blog

12 luglio 2026

Invia la tua prima campagna con le API Qulaq in 10 minuti

Ottieni un token JWT, crea la campagna, invia: tre richieste e hai le basi della marketing automation.

12 luglio 2026

Eventi email in tempo reale con i webhook

Basta interrogare l'API per bounce e reclami: falli arrivare subito nel tuo sistema con i webhook firmati HMAC.

12 luglio 2026

Verifica email in tempo reale nel form di registrazione

Intercetta gli indirizzi non validi già al momento dell'iscrizione: integra il form con la verify API.