Domény

Přidávejte odesílací domény, čtěte jejich DNS záznamy a stav ověření a ověřujte je.

Základní URLhttps://api.emailit.com/v2Autentizace Chyby Limity rychlosti

POST/domains
GET/domains/{id}
POST/domains/{id}/verify
POST/domains/{id}
GET/domains
DEL/domains/{id}

Vytvoření domény

Přidá odesílací doménu a vrátí DNS záznamy, které pro ni přidáte do DNS.

POST/domains

Vyžaduje API klíč s oprávněním full. Emailit pro doménu vygeneruje 2048bitový klíč DKIM. Záznamy z pole dns_records přidejte u svého poskytovatele DNS a potom zavolejte endpoint Ověření domény. Jakmile je doména ověřená, můžete z ní odesílat. Viz Přidání odesílací domény a DNS záznamy odesílacích domén.

Počet domén závisí na tarifu: 3 v tarifu Pay as you go (25 po prvním nákupu kreditů), 100 v tarifu Pro a 1 000 v tarifu Business. Vyvolá událost domain.created.

Parametry v těle požadavku

namestringpovinné

Doména, ze které budete odesílat, například acme.com nebo mail.acme.com, bez http://, https:// a www.. Ukládá se malými písmeny. Adresy v poli from musí používat přesně tuto doménu.

tracking_keystring

Název subdomény pro CNAME záznam pro měření otevření a prokliků. Výchozí hodnota je go, což dává go.acme.com. Písmena, číslice a pomlčky.

inbound_keystring

Název subdomény pro příjem e-mailů. Výchozí hodnota je inbound, což dává inbound.acme.com. Písmena, číslice a pomlčky.

dmarc_reportsbooleanvýchozí: false

Sbírat pro doménu DMARC reporty. Emailit vytvoří adresu pro reporty a přidá ji do navrhovaného záznamu DMARC. Dostupné v tarifech Pro, Business a Custom. Viz DMARC reporty.

track_loadsbooleanvýchozí: false

Při vytváření domény musí být false. Měření zapněte endpointem Úprava domény, jakmile bude CNAME záznam pro měření ověřený.

track_clicksbooleanvýchozí: false

Totéž co track_loads, pro měření prokliků.

Starší příznaky outgoing, incoming a use_for_any se kvůli kompatibilitě přijímají, ale nemají žádný účinek.

Odpověď

Vrací 201 s objektem domény včetně pole dns_records. Nová doména má stav pending, v tarifu Pay as you go do první kontroly DNS stav pending_review.

POST/domains

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.create({ name: 'acme.com' });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.create({"name": "acme.com"})

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->create(['name' => 'acme.com']);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.create(name: "acme.com")

import "github.com/emailit/emailit-go/v2"

client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Create(&emailit.CreateDomainRequest{Name: "acme.com"})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.create(emailit::types::CreateDomainParams::new("acme.com")).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().create(DomainCreateParams.builder().setName("acme.com").build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Create(new DomainCreateOptions { Name = "acme.com" });

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->create(['name' => 'acme.com']);

Terminal

curl https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "acme.com"}'

Terminal

curl https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "acme.com",
    "tracking_key": "links",
    "inbound_key": "reply",
    "dmarc_reports": true
  }'

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": null,
  "manually_verified_at": null,
  "manual_review_required": false,
  "verification_status": "pending",
  "dkim_identifier_string": "emailit",
  "dns_checked_at": null,
  "spf_status": "pending",
  "spf_error": null,
  "dkim_status": "pending",
  "dkim_error": null,
  "mx_status": "pending",
  "mx_error": null,
  "return_path_status": "pending",
  "return_path_error": null,
  "dmarc_status": "pending",
  "dmarc_error": null,
  "tracking_status": "pending",
  "tracking_error": null,
  "tracking_key": null,
  "inbound_status": "pending",
  "inbound_error": null,
  "inbound_key": null,
  "track_loads": 0,
  "track_clicks": 0,
  "dmarc_reports": false,
  "dmarc_address": null,
  "created_at": "2026-10-01T09:12:03.551208Z",
  "updated_at": "2026-10-01T09:12:03.551208Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none;",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}

JSON

{
  "error": "The domain must be in apex format (e.g., domain.com) without http://, https://, or www."
}

JSON

{
  "error": "plan_required",
  "required_plan": "pro"
}

JSON

{
  "error": "Domain with this name already exists",
  "existing": {
    "object": "domain",
    "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
    "name": "acme.com"
  }
}

JSON

{
  "error": "Pay as you go includes 3 domain(s)."
}

JSON

{
  "error": "Tracking requires a verified custom CNAME. New messages are not rewritten to a shared tracking URL."
}

Načtení domény

Načte odesílací doménu se stavem ověření a DNS záznamy.

GET/domains/{id}

Vyžaduje API klíč s oprávněním full. Stavy záznamů odpovídají poslední kontrole DNS, která proběhne, když zavoláte endpoint Ověření domény, a automaticky jednou denně.

Parametry v cestě

idstringpovinné

ID domény (dom_…, u starších domén sd_… a sed_…), nebo název domény, například acme.com.

Odpověď

Vrací objekt domény.

objectstring

Vždy domain.

idstring

ID domény.

namestring

Název domény.

verification_statusstring

verified, když doména může odesílat. pending, dokud SPF, DKIM nebo return path ještě nejsou v pořádku. pending_review v tarifu Pay as you go, když doména před ověřením potřebuje ruční kontrolu od Emailitu, například protože byla zaregistrována před méně než 30 dny.

verified_atstring | null

Kdy naposledy prošla kontrola DNS, nebo null, pokud doména není ověřená. Neúspěšná kontrola hodnotu vymaže.

manual_review_requiredboolean

Jestli doména čeká na ruční kontrolu od Emailitu.

manually_verified_atstring | null

Kdy Emailit doménu ručně schválil, nebo null.

dns_checked_atstring | null

Kdy byly DNS záznamy naposledy zkontrolovány.

spf_status, dkim_status, return_path_statusstring

Stav tří povinných záznamů: pending (zatím nezkontrolovaný), ok, missing nebo invalid. Aby byla doména ověřená, musí mít všechny tři stav ok.

mx_statusstring

Totéž co return_path_status.

dmarc_statusstring

Stav záznamu DMARC: pending, ok, missing, invalid nebo error. Pro ověření není povinný.

tracking_statusstring

Stav CNAME záznamu pro měření. Než můžete měření zapnout, musí být ok.

inbound_statusstring

Stav příchozího MX záznamu. Je potřeba k příjmu e-mailů na doméně.

spf_error, dkim_error, mx_error, return_path_error, dmarc_error, tracking_error, inbound_errorstring | null

Co je s jednotlivými záznamy po neúspěšné kontrole špatně, nebo null.

tracking_keystring | null

Název subdomény pro měření, nebo null pro výchozí go.

inbound_keystring | null

Název příchozí subdomény, nebo null pro výchozí inbound.

track_loadsinteger

1, pokud je měření otevření pro e-maily z této domény ve výchozím stavu zapnuté, jinak 0.

track_clicksinteger

1, pokud je měření prokliků ve výchozím stavu zapnuté, jinak 0.

dmarc_reportsboolean

Jestli Emailit pro doménu sbírá DMARC reporty.

dmarc_addressstring | null

Adresa, na kterou chodí DMARC reporty, nebo null, když je dmarc_reports vypnuté.

verification_token, verification_method, dkim_identifier_stringstring

Interní údaje o ověření. verification_method je dns a dkim_identifier_string je selektor DKIM, emailit.

created_at, updated_atstring

Kdy byla doména přidána a kdy naposledy změněna.

dns_recordsobject[]

Záznamy, které máte přidat do DNS. Každý má type (MX, TXT nebo CNAME), name, value, priority (u MX záznamů), ttl (auto), required (jestli je potřeba k ověření) a svůj aktuální status a error.

Záznam	Typ	Název	Hodnota	Povinné
Return path	MX	`emailit.acme.com`	`feedback-smtp.ffdc-1.emailit.com`, priorita 10	Ano
SPF	TXT	`emailit.acme.com`	`v=spf1 include:_spf.emailit.com ~all`	Ano
DKIM	TXT	`emailit._domainkey.acme.com`	`v=DKIM1; t=s; h=sha256; p=…`	Ano
DMARC	TXT	`_dmarc.acme.com`	`v=DMARC1; p=none;` a adresy pro reporty, když je `dmarc_reports` zapnuté	Ne
Měření	CNAME	`go.acme.com`	`go.emailitmail.com`	Ne
Příchozí pošta	MX	`inbound.acme.com`	`inbound.emailitmail.com`, priorita 10	Ne

GET/domains/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.get('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.get("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->get('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.get("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Get("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.get("dom_4K468YrjOkR1wwdhqiO0G9XEUey").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().get("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Get("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->get('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Terminal

curl https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": "2026-10-01T03:00:12.000000Z",
  "manually_verified_at": null,
  "manual_review_required": false,
  "verification_status": "verified",
  "dkim_identifier_string": "emailit",
  "dns_checked_at": "2026-10-01T03:00:12.000000Z",
  "spf_status": "ok",
  "spf_error": null,
  "dkim_status": "ok",
  "dkim_error": null,
  "mx_status": "ok",
  "mx_error": null,
  "return_path_status": "ok",
  "return_path_error": null,
  "dmarc_status": "ok",
  "dmarc_error": null,
  "tracking_status": "ok",
  "tracking_error": null,
  "tracking_key": null,
  "inbound_status": "invalid",
  "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
  "inbound_key": null,
  "track_loads": 1,
  "track_clicks": 1,
  "dmarc_reports": true,
  "dmarc_address": "4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com",
  "created_at": "2026-09-14T08:02:51.000000Z",
  "updated_at": "2026-10-01T03:00:12.000000Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none; rua=mailto:4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com; ruf=mailto:4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryMx ENOTFOUND inbound.acme.com"
    }
  ]
}

JSON

{
  "error": "Domain not found"
}

Ověření domény

Okamžitě vyhledá DNS záznamy domény, uloží výsledek a vrátí doménu s novými stavy.

POST/domains/{id}/verify

Vyžaduje API klíč s oprávněním full. Zavolejte ho po přidání záznamů z endpointu Vytvoření domény do DNS a znovu pokaždé, když je změníte. Šíření změn v DNS může chvíli trvat, takže pokud má záznam stav missing, počkejte pár minut a zkuste to znovu.

Doména dostane stav verified, když mají všechny tři povinné záznamy stav ok:

SPF: TXT záznam na emailit.<domain>, který obsahuje _spf.emailit.com.
DKIM: TXT záznam na emailit._domainkey.<domain> s veřejným klíčem domény.
Return path: jediný MX záznam na emailit.<domain>, který odkazuje na feedback-smtp.ffdc-1.emailit.com.

V tarifu Pay as you go dostane doména zaregistrovaná před méně než 30 dny místo toho stav pending_review a Emailit ji zkontroluje ručně. Kontrolují se i záznamy DMARC, pro měření a pro příchozí poštu, ověření ale neovlivňují.

Emailit navíc každou doménu jednou denně kontroluje znovu. Pokud některý povinný záznam přestane kontrolou procházet, doména přestane být ověřená, odesílání z ní selže a vlastník workspace dostane e-mail. Viz Ověření domény.

Parametry v cestě

idstringpovinné

ID domény, nebo název domény.

Odpověď

Vrací objekt domény s výsledkem této kontroly v poli verification_status, ve všech polích *_status a *_error a v dns_records. Tato odpověď neobsahuje dmarc_reports a dmarc_address; ty načtete endpointem Načtení domény.

POST/domains/{id}/verify

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.verify('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->verify('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Verify("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->verify('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Terminal

curl -X POST https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey/verify \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": null,
  "manually_verified_at": null,
  "manual_review_required": false,
  "dkim_identifier_string": "emailit",
  "dns_checked_at": "2026-10-01T09:20:41.000000Z",
  "spf_status": "ok",
  "spf_error": null,
  "dkim_status": "missing",
  "dkim_error": "queryTxt ENOTFOUND emailit._domainkey.acme.com",
  "mx_status": "ok",
  "mx_error": null,
  "return_path_status": "ok",
  "return_path_error": null,
  "dmarc_status": "error",
  "dmarc_error": "queryTxt ENOTFOUND _dmarc.acme.com",
  "tracking_status": "invalid",
  "tracking_error": "queryCname ENOTFOUND go.acme.com",
  "tracking_key": null,
  "inbound_status": "invalid",
  "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
  "inbound_key": null,
  "track_loads": 0,
  "track_clicks": 0,
  "created_at": "2026-10-01T09:12:03.000000Z",
  "updated_at": "2026-10-01T09:20:41.000000Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "missing",
      "error": "queryTxt ENOTFOUND emailit._domainkey.acme.com"
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none;",
      "priority": null,
      "ttl": "auto",
      "status": "error",
      "error": "queryTxt ENOTFOUND _dmarc.acme.com"
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryCname ENOTFOUND go.acme.com"
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryMx ENOTFOUND inbound.acme.com"
    }
  ],
  "verification_status": "pending"
}

JSON

{
  "error": "Domain not found"
}

Úprava domény

Upraví nastavení odesílací domény. Změní se jen pole, která pošlete.

POST/domains/{id}

Vyžaduje API klíč s oprávněním full. Vyvolá událost domain.updated.

Parametry v cestě

idstringpovinné

ID domény, nebo název domény.

Parametry v těle požadavku

track_loadsboolean

Zapne, nebo vypne výchozí měření otevření pro e-maily z této domény. Zapnutí vyžaduje ověřený CNAME záznam pro měření (tracking_status je ok). Viz Nastavení vlastní domény pro měření.

track_clicksboolean

Zapne, nebo vypne výchozí měření prokliků. Platí stejný požadavek jako u track_loads.

tracking_keystring | null

Nový název subdomény pro CNAME záznam pro měření, nebo null pro výchozí go. Změna vrátí tracking_status na pending, takže přidejte do DNS nový CNAME záznam a doménu znovu ověřte.

inbound_keystring | null

Nový název subdomény pro příjem e-mailů, nebo null pro výchozí inbound. Změna vrátí inbound_status na pending.

dmarc_reportsboolean

Sbírat pro doménu DMARC reporty. Zapnutí přidá do navrhovaného záznamu DMARC adresu pro reporty, takže potom upravte svůj záznam _dmarc. Jen v tarifech Pro, Business a Custom. Po vypnutí zůstane adresa uložená pro pozdější použití.

namestring

Nový název domény. DNS záznamy se přesunou k novému názvu, takže je přidejte do DNS u něj a než z něj začnete odesílat, doménu znovu ověřte.

Starší příznaky outgoing, incoming a use_for_any se přijímají, ale nemají žádný účinek. Neznámá pole se ignorují. Požadavek, který neobsahuje žádné z těchto polí, vrací 400.

Odpověď

Vrací upravený objekt domény včetně dns_records.

POST/domains/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domain = await emailit.domains.update('dom_4K468YrjOkR1wwdhqiO0G9XEUey', { track_clicks: false });

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domain = client.domains.update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", {"track_clicks": False})

PHP

$emailit = Emailit::client('your_api_key');

$domain = $emailit->domains()->update('dom_4K468YrjOkR1wwdhqiO0G9XEUey', ['track_clicks' => false]);

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domain = client.domains.update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", track_clicks: false)

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domain, err := client.Domains.Update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", &emailit.UpdateDomainRequest{TrackClicks: false})

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domain = emailit.domains.update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", emailit::types::UpdateDomainParams { track_clicks: Some(false), ..Default::default() }).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domain = emailit.domains().update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", DomainUpdateParams.builder().setTrackClicks(false).build());

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domain = emailit.Domains.Update("dom_4K468YrjOkR1wwdhqiO0G9XEUey", new DomainUpdateOptions { TrackClicks = false });

PHP

use Emailit\Laravel\Facades\Emailit;

$domain = Emailit::domains()->update('dom_4K468YrjOkR1wwdhqiO0G9XEUey', ['track_clicks' => false]);

Terminal

curl -X POST https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"track_clicks": false}'

Terminal

curl -X POST https://api.emailit.com/v2/domains/acme.com \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"track_loads": true, "track_clicks": true}'

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
  "verification_method": "dns",
  "verified_at": "2026-10-01T03:00:12.000000Z",
  "manually_verified_at": null,
  "manual_review_required": false,
  "verification_status": "verified",
  "dkim_identifier_string": "emailit",
  "dns_checked_at": "2026-10-01T03:00:12.000000Z",
  "spf_status": "ok",
  "spf_error": null,
  "dkim_status": "ok",
  "dkim_error": null,
  "mx_status": "ok",
  "mx_error": null,
  "return_path_status": "ok",
  "return_path_error": null,
  "dmarc_status": "ok",
  "dmarc_error": null,
  "tracking_status": "ok",
  "tracking_error": null,
  "tracking_key": null,
  "inbound_status": "invalid",
  "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
  "inbound_key": null,
  "track_loads": 1,
  "track_clicks": 0,
  "dmarc_reports": false,
  "dmarc_address": null,
  "created_at": "2026-09-14T08:02:51.000000Z",
  "updated_at": "2026-10-01T10:44:20.000000Z",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit._domainkey.acme.com",
      "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAx3kQ...IDAQAB;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "TXT",
      "name": "_dmarc.acme.com",
      "value": "v=DMARC1; p=none;",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "CNAME",
      "name": "go.acme.com",
      "value": "go.emailitmail.com",
      "priority": null,
      "ttl": "auto",
      "status": "ok",
      "error": null
    },
    {
      "required": false,
      "type": "MX",
      "name": "inbound.acme.com",
      "value": "inbound.emailitmail.com",
      "priority": 10,
      "ttl": "auto",
      "status": "invalid",
      "error": "queryMx ENOTFOUND inbound.acme.com"
    }
  ]
}

JSON

{
  "error": "No valid fields provided for update. Provide at least one of: name, outgoing, incoming, use_for_any, track_loads, track_clicks, tracking_key, inbound_key, dmarc_reports"
}

JSON

{
  "error": "plan_required",
  "required_plan": "pro"
}

JSON

{
  "error": "Domain not found"
}

JSON

{
  "error": "Another domain with this name already exists"
}

JSON

{
  "error": "Tracking requires a verified custom CNAME. New messages are not rewritten to a shared tracking URL."
}

Výpis domén

Vrací stránku odesílacích domén od nejnovějších spolu s počtem domén, který povoluje váš tarif.

GET/domains

Vyžaduje API klíč s oprávněním full. Položky seznamu neobsahují dns_records; ty získáte endpointem Načtení domény.

Parametry dotazu

pageintegervýchozí: 1

Stránka, kterou chcete načíst.

limitintegervýchozí: 10

Počet domén na stránce, od 1 do 100.

searchstring

Hledá v názvu domény bez ohledu na velikost písmen.

matchstringvýchozí: all

all, nebo or. Určuje, jak se kombinují filtry níže.

orderstring

Klíč filtru, podle kterého se řadí.

directionstring

asc, nebo desc.

Filtry

Filtry přidejte ve tvaru key.condition=value, například dkim_status.exact=ok. Viz Filtrování a řazení.

Klíč	Typ	Hodnoty a poznámky
`name`	string
`created_at`	date
`spf_status`	enum	`ok`, `missing`, `invalid`
`dkim_status`	enum	`ok`, `missing`, `invalid`
`return_path_status`	enum	`ok`, `missing`, `invalid`

Podle každého klíče lze také řadit.

Odpověď

dataobject[]

Objekty domén na této stránce, bez dns_records.

next_page_urlstring | null

Cesta k další stránce, nebo null. Viz Stránkování.

previous_page_urlstring | null

Cesta k předchozí stránce, nebo null.

domain_limitinteger | null

Kolik odesílacích domén váš tarif povoluje, nebo null, pokud limit není.

domain_countinteger

Kolik odesílacích domén má workspace, napříč všemi stránkami.

plan_namestring | null

Název vašeho tarifu, například Pay as you go nebo Pro.

GET/domains

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const domains = await emailit.domains.list();

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

domains = client.domains.list()

PHP

$emailit = Emailit::client('your_api_key');

$domains = $emailit->domains()->list();

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

domains = client.domains.list

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

domains, err := client.Domains.List(nil)

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let domains = emailit.domains.list(None).await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject domains = emailit.domains().list();

using Emailit;

var emailit = new EmailitClient("your_api_key");

var domains = emailit.Domains.List();

PHP

use Emailit\Laravel\Facades\Emailit;

$domains = Emailit::domains()->list();

Terminal

curl https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Terminal

curl -G https://api.emailit.com/v2/domains \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d dkim_status.not_exact=ok \
  -d spf_status.not_exact=ok \
  -d match=or

JSON

{
  "data": [
    {
      "object": "domain",
      "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
      "name": "acme.com",
      "verification_token": "vt_4KY8weirBN9sxnfbIt78tsFWteY",
      "verification_method": "dns",
      "verified_at": "2026-10-01T03:00:12.000000Z",
      "manually_verified_at": null,
      "manual_review_required": false,
      "verification_status": "verified",
      "dkim_identifier_string": "emailit",
      "dns_checked_at": "2026-10-01T03:00:12.000000Z",
      "spf_status": "ok",
      "spf_error": null,
      "dkim_status": "ok",
      "dkim_error": null,
      "mx_status": "ok",
      "mx_error": null,
      "return_path_status": "ok",
      "return_path_error": null,
      "dmarc_status": "ok",
      "dmarc_error": null,
      "tracking_status": "ok",
      "tracking_error": null,
      "tracking_key": null,
      "inbound_status": "invalid",
      "inbound_error": "queryMx ENOTFOUND inbound.acme.com",
      "inbound_key": null,
      "track_loads": 1,
      "track_clicks": 1,
      "dmarc_reports": true,
      "dmarc_address": "4KXUJdXRVlVgbkWQm4GHLy8BleP@dmarc.emailitmail.com",
      "created_at": "2026-09-14T08:02:51.000000Z",
      "updated_at": "2026-10-01T03:00:12.000000Z"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null,
  "domain_limit": 100,
  "domain_count": 1,
  "plan_name": "Pro"
}

Smazání domény

Trvale smaže odesílací doménu.

DELETE/domains/{id}

Vyžaduje API klíč s oprávněním full. Po smazání skončí odesílání z domény chybou Domain not verified a API klíče omezené na tuto doménu už nemohou odesílat. Odstraní se také klíč DKIM domény, historie kondice odesílání a případné uložené propojení s Cloudflare. Už odeslané e-maily zůstanou ve vašich logech. Vyvolá událost domain.deleted.

Pokud chcete z domény znovu odesílat, znovu ji vytvořte. Dostane nový klíč DKIM, takže budete muset upravit záznam DKIM.

Parametry v cestě

idstringpovinné

ID domény, nebo název domény.

Odpověď

objectstring

Vždy domain.

idstring

ID smazané domény.

namestring

Název domény.

deletedboolean

Vždy true.

DELETE/domains/{id}

JavaScript

import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

await emailit.domains.delete('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Python

from emailit import EmailitClient
client = EmailitClient("your_api_key")

client.domains.delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

PHP

$emailit = Emailit::client('your_api_key');

$emailit->domains()->delete('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Ruby

require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

client.domains.delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

err := client.Domains.Delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey")

Rust

use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

emailit.domains.delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey").await?;

Java

import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

emailit.domains().delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

using Emailit;

var emailit = new EmailitClient("your_api_key");

emailit.Domains.Delete("dom_4K468YrjOkR1wwdhqiO0G9XEUey");

PHP

use Emailit\Laravel\Facades\Emailit;

Emailit::domains()->delete('dom_4K468YrjOkR1wwdhqiO0G9XEUey');

Terminal

curl -X DELETE https://api.emailit.com/v2/domains/dom_4K468YrjOkR1wwdhqiO0G9XEUey \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

JSON

{
  "object": "domain",
  "id": "dom_4K468YrjOkR1wwdhqiO0G9XEUey",
  "name": "acme.com",
  "deleted": true
}

JSON

{
  "error": "Domain not found"
}