E-mailové API

E-mailové API odesílá e-maily z vaší aplikace přes HTTPS místo připojení SMTP. Používejte ho pro transakční e-maily, jako jsou potvrzení registrace, obnovení hesla, účtenky a upozornění, zvlášť když chcete šablony, plánování, bezpečné opakování požadavků a samostatné ID pro každého příjemce.

Jak to funguje

1. Vaše aplikace zavolá POST /emails s adresou odesílatele na ověřené odesílací doméněOdesílací doménaDoména, kterou vlastníte a ověříte DNS záznamy, aby z ní Emailit mohl odesílat poštu se SPF, DKIM a vlastním return path., s příjemci a s obsahem nebo šablonou.
2. Emailit požadavek zvaliduje, účtuje 1 kredit za každého příjemce a pro každého příjemce vytvoří jeden e-mail s vlastním ID em_.
3. Odpověď přijde hned se stavem accepted, nebo scheduled, pokud jste nastavili čas odeslání. Doručení probíhá na pozadí.
4. Emailit zprávu podepíše DKIM pro vaši doménu, provede kontroly spamu a doručí ji. Při dočasných chybách zkouší doručení znovu přibližně 21 hodin.
5. Každá změna stavu se zobrazí v Email API›Emails a odešle se na vaše webhooky.

Základní URL a autentizace

Klíč s oprávněním Full Access může volat všechny endpointy. Klíč s oprávněním Sending Only může e-maily odesílat, přeplánovat, rušit, odesílat znovu a přeposílat a můžete ho omezit na jednu odesílací doménu. Podrobnosti najdete na stránce Autentizace.

Odešlete e-mail

curl https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada."
  }'

import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up, Ada.</p>',
  text: 'Thanks for signing up, Ada.',
});

console.log(email.id);

import os
from emailit import EmailitClient

client = EmailitClient(os.environ["EMAILIT_API_KEY"])

email = client.emails.send({
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Welcome to Acme",
    "html": "<p>Thanks for signing up, Ada.</p>",
    "text": "Thanks for signing up, Ada.",
})

$emailit = Emailit::client(getenv('EMAILIT_API_KEY'));

$email = $emailit->emails()->send([
    'from' => 'Acme <hello@acme.com>',
    'to' => 'ada@example.com',
    'subject' => 'Welcome to Acme',
    'html' => '<p>Thanks for signing up, Ada.</p>',
    'text' => 'Thanks for signing up, Ada.',
]);

Úspěšný požadavek vrací 200 s novým e-mailem:

{
  "object": "email",
  "id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
  "token": "33VtK8m4XcPq2RwZ7nLb1YsTgHd",
  "message_id": "<33VtK8m4XcPq2RwZ7nLb1YsTgHd@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com"],
  "subject": "Welcome to Acme",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.418203Z",
  "tracking": { "loads": false, "clicks": false }
}

Nové workspace začínají v režimu sandbox a mohou odesílat jen na e-mailové adresy účtů členů workspace. Než začnete odesílat komukoli jinému, požádejte o produkční přístup.

Co můžete dělat

Limity

Limity rychlosti počítají příjemce, takže jeden požadavek na 10 příjemců spotřebuje 10 z vašeho limitu za sekundu i z denního limitu. Workspace v tarifech Pro a Business dostávají automatická navýšení podle kondice odesílání a každý workspace může požádat o vyšší limity v panelu Sending Limits na úvodní stránce webového rozhraní. Viz Limity a Limity rychlosti.

Kredity

Každý příjemce stojí 1 kredit a počítají se adresy v to, cc i bcc. Pokud workspace nemá dost kreditů pro všechny příjemce, požadavek selže s 402 a nic se neodešle. Opakovaná odeslání a přeposlání se účtují jako nová odeslání.

Jak se čerpají kredity v ceně tarifu a zakoupené kredity, najdete na stránce Kredity.

Další kroky