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.

.env
SENDHQ_API_KEY=re_your_key_here

2. 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.

Do not publish a second SPF policy.If SPF already exists, merge SendHQ's SPF include (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
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.