Riferimento API
Un unico contratto per l'intera superficie rivolta ai clienti.
Gli endpoint per i clienti sono disponibili sotto /api/v1. Il prefisso legacy /api resta disponibile per la dashboard, ma le nuove integrazioni lato server devono usare l'URL di base con versione.
Confini dell'autenticazione
Le integrazioni di prodotto usano una chiave API del workspace, che può anche leggere l'utilizzo dell'account, le analytics e i metadati delle chiavi API. Le modifiche alla fatturazione e la creazione o revoca delle chiavi API richiedono la sessione del browser HTTP-only e sono indicate di conseguenza.
Risorse
Email e thread
Invia, recupera, cerca, rispondi e controlla gli eventi di consegna.
8 operazioniEtichette e regole di archiviazione
Organizza la posta inviata e ricevuta in cartelle, automaticamente o a mano.
9 operazioniBozze e allegati
Costruisci flussi di composizione con archiviazione privata degli allegati.
10 operazioniTemplate ospitati
Crea bozze, renderizza, testa, versiona, pubblica e invia contenuti riutilizzabili.
7 operazioniDomini
Crea identità di invio e interpreta lo stato della verifica DNS.
8 operazioniEmail in entrata
Crea indirizzi e lavora con le conversazioni ricevute.
9 operationsDeliverability
Controlla eventi, esiti di reputazione e destinatari bloccati.
10 operationsWebhooks
Receive signed, retried email events (sent, delivered, delayed, bounced, complained, failed, received) at your own endpoints.
47 operationsCampaigns
Store contacts with their consent basis, tags, and custom fields, organize them into lists with hosted double opt-in signup forms, welcome emails, and public newsletter sites, target segments, import and export CSV files, and send, test, and schedule broadcasts with merge tags, per-list one-click unsubscribe, pre-send checks, bot-filtered open and click reports, and per-recipient outcomes.
36 operationsAutomations
Record what contacts do as events, and run timed sequences of emails that start on an event, stop when the contact converts, and share per-person sending limits. Create and edit automations, their emails and language versions, turn them on and off, and add or remove people. Available to enabled workspaces.
9 operationsAccount e fatturazione
Leggi utilizzo dell'account, analytics e metadati delle chiavi con una chiave API; le modifiche alla fatturazione e la creazione o revoca delle chiavi richiedono una sessione della dashboard.
Struttura degli errori
Gli errori JSON usano un'unica struttura prevedibile. I codici di stato distinguono input non valido, autenticazione, risorse mancanti, conflitti, pagamento richiesto, blocchi di sicurezza e limiti di utilizzo.
{
"error": {
"message": "The sender domain is not verified",
"status": 403
}
}Versioni
La versione dell'API basata sulla data identifica questo contratto. All'interno della versione possono essere aggiunti campi retrocompatibili. Le modifiche incompatibili richiedono un nuovo percorso di base con versione e una transizione documentata.
{
"version": "2026-09-07",
"baseUrl": "https://sendhq.cc/api/v1",
"openapi": "https://sendhq.cc/openapi.json"
}