Reference API

API Emailitu je REST API dostupné přes HTTPS. Posíláte JSON, dostáváte zpět JSON a každý požadavek autentizujete bearer tokenem. Používejte ho k odesílání e-mailů a ke správě všeho ostatního ve workspace: odesílacích domén, API klíčů, kontaktů, seznamů kontaktů, kampaní, šablon, webhooků a dalšího.

Základní URL

Každý požadavek míří na základní URL verze 2:

https://api.emailit.com/v2

Cesty v této referenci jsou relativní k ní. Například POST /emails znamená POST https://api.emailit.com/v2/emails.

Pošlete první požadavek

Tento požadavek odešle jeden e-mail. Odesílatele nahraďte adresou na ověřené odesílací doméně a do EMAILIT_API_KEY nastavte jeden ze svých API klíčů.

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.</p>"
  }'

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.</p>',
});

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.</p>",
})

Odpovědí je nový objekt e-mailu s jeho ID (em_…) a stavem accepted. Všechny možnosti najdete na stránce Odeslání e-mailu.

Autentizace

V hlavičce Authorization předejte API klíč, nebo přístupový token OAuth:

Authorization: Bearer secret_••••••••••••••••••••••••••••••••

API klíče začínají na secret_ a patří do jednoho workspace. Klíč má oprávnění full (všechny endpointy), nebo sending (jen endpointy pro odesílání) a klíč pro odesílání lze omezit na jednu odesílací doménu. Požadavky bez platného klíče selžou s 401. Viz Autentizace.

Požadavky a odpovědi

• JSON dovnitř, JSON ven. Těla požadavků posílejte jako JSON s Content-Type: application/json. Tělo, které není platný JSON, vrátí 400 se zprávou Invalid JSON in request body. Tělo požadavku smí mít nejvýše 50 MB.
• Metody. GET čte, POST vytváří a upravuje a DELETE maže. API nepoužívá PUT ani PATCH.
• Objekty. Každý objekt má pole object, které určuje jeho typ (email, domain, api_key, audience, subscriber, contact, …), a id.
• Časová razítka. Data jsou řetězce podle ISO 8601 v UTC s přesností na mikrosekundy, například 2026-10-01T09:30:12.482913Z. Nenastavená pole mají hodnotu null.
• Výpisy. Endpointy pro výpisy jsou stránkované a většina přijímá filtry a řazení. Viz Stránkování a Filtrování.
• Chyby. Neúspěšné požadavky vracejí stavový kód 4xx nebo 5xx a tělo JSON s vysvětlením problému. Viz Chyby.

ID objektů

ID jsou řetězce složené z předpony typu a 27 písmen a číslic, například em_4KYof1ZzXndZE2VPi0DgULiekG8. ID rozlišují velikost písmen a jsou přibližně seřazená podle času vytvoření.

Některé zdroje přijímají v cestě také čitelný identifikátor. Domény, API klíče, seznamy kontaktů, kampaně a webhooky přijímají svůj název (GET /domains/acme.com). Kontakty a blokované adresy přijímají e-mailovou adresu a odběratelé e-mailovou adresu kontaktu. Názvy a adresy se speciálními znaky zakódujte do URL. Domény vytvořené před přechodem na ID dom_ si ponechávají své ID sd_ nebo sed_ a tato ID stále fungují.

Verzování

Aktuální verze je v2 a je součástí základní URL. Nová pole a endpointy se do v2 přidávají bez změny verze, takže klienty pište tak, aby ignorovaly pole, která neznají. Viz Verzování.

Zdroje

Všechny endpointy a oprávnění, která potřebují, v jedné tabulce najdete na stránce Všechny endpointy.

SDK

Oficiální knihovny obalují API pro nejčastější jazyky. Jsou open source na GitHubu.

Webhooky a události

Místo opakovaného dotazování na změny stavu si zaregistrujte webhook a Emailit bude na váš endpoint posílat podepsané dávky událostí hned, jak nastanou: doručení, nedoručení, otevření, prokliky, nové kontakty a další. Stejné události jsou dostupné přes Výpis událostí. Úplný seznam najdete na stránce Typy událostí.

MCP server

Hostovaný MCP server na https://api.emailit.com/mcp umožňuje AI asistentům, jako jsou ChatGPT, Claude, Cursor, Codex a Grok, volat toto API za vás: 109 nástrojů pokrývá všechny zdroje na této stránce. Asistenti se přihlašují přes OAuth, nebo používají API klíč, se stejnými oprávněními. Viz MCP server a referenci nástrojů.

Související