Per iniziare
Guida rapida
Crea una chiave, verifica un dominio e invia un'email controllata con una richiesta sicura da ritentare.
Prima di iniziare
Create a SendHQ workspace and keep the dashboard open. You can verify a domain and create an API key before paying. Sending requires an active subscription: there is no free allowance, including to your own address. Choose a plan at pricing.
1. Crea una chiave API
Apri Chiavi API nella dashboard, scegli un nome descrittivo come Production e copia la chiave quando viene mostrata. Conservala in un secret manager lato server. SendHQ non restituisce mai più il valore completo.
SENDHQ_API_KEY=re_your_key_here2. Aggiungi un dominio di invio
Open Domains, add a domain you control, and publish the returned DKIM, SPF, DMARC, and domain verification records. Copy the records into your DNS host and click Verify. On Cloudflare, add them as DNS only (grey cloud). Add the records, then click Verify.
include:amazonses.com) into the existing v=spf1 value.3. Attendi la verifica
Use the dashboard or POST /domains/:id/verify. DNS can move through pending, checking, and propagating before the sending identity is verified.
4. Invia un messaggio controllato
curl https://sendhq.cc/api/v1/emails \
-H "Authorization: Bearer $SENDHQ_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: onboarding-user-42" \
-d '{"from":"Acme <hello@example.com>","to":["owner@example.com"],"subject":"SendHQ is connected","html":"<h1>It works</h1><p>Your first controlled message was accepted.</p>","text":"It works. Your first controlled message was accepted."}'Una richiesta riuscita restituisce l'ID email SendHQ, l'ID messaggio del provider e l'ID del thread della conversazione. Salva l'ID SendHQ insieme all'evento applicativo che ha generato l'email.
5. Gestisci gli esiti
Una richiesta API accettata non equivale alla consegna al destinatario. Recupera /emails/:id/events o usa la dashboard per consultare gli eventi di consegna, bounce, segnalazione di spam, rifiuto, apertura e clic.