Registrar dominio de correo

curl --request POST \
  --url https://api.notifique.dev/v1/email/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "suempresa.com"
}
'

{
  "success": true,
  "data": {
    "id": "clxx123...",
    "domain": "seudominio.com",
    "status": "PENDING",
    "dnsRecords": [
      {
        "type": "TXT",
        "name": "notifique._domainkey.seudominio.com",
        "value": "p=MIGf..."
      }
    ],
    "createdAt": "2025-02-15T10:00:00.000Z"
  },
  "message": "Add the DNS record(s) above to your domain, then call the verify endpoint or use the Verify button in the dashboard."
}

{
  "success": false,
  "error": "Bad Request",
  "message": "Invalid domain",
  "details": [
    {
      "field": "domain",
      "message": "domain must be a valid domain name"
    }
  ],
  "code": "BAD_REQUEST"
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

{
  "success": false,
  "error": "Plan limit reached",
  "message": "Your plan allows up to N domain(s). Upgrade to add more.",
  "code": "PLAN_LIMIT_EMAIL_DOMAINS"
}

{
  "success": false,
  "error": "Conflict",
  "message": "This domain is already registered for this workspace.",
  "data": {
    "id": "clxx...",
    "domain": "seudominio.com",
    "status": "PENDING"
  },
  "code": "CONFLICT"
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

POST

domains

curl --request POST \
  --url https://api.notifique.dev/v1/email/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "suempresa.com"
}
'

{
  "success": true,
  "data": {
    "id": "clxx123...",
    "domain": "seudominio.com",
    "status": "PENDING",
    "dnsRecords": [
      {
        "type": "TXT",
        "name": "notifique._domainkey.seudominio.com",
        "value": "p=MIGf..."
      }
    ],
    "createdAt": "2025-02-15T10:00:00.000Z"
  },
  "message": "Add the DNS record(s) above to your domain, then call the verify endpoint or use the Verify button in the dashboard."
}

{
  "success": false,
  "error": "Bad Request",
  "message": "Invalid domain",
  "details": [
    {
      "field": "domain",
      "message": "domain must be a valid domain name"
    }
  ],
  "code": "BAD_REQUEST"
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

{
  "success": false,
  "error": "Plan limit reached",
  "message": "Your plan allows up to N domain(s). Upgrade to add more.",
  "code": "PLAN_LIMIT_EMAIL_DOMAINS"
}

{
  "success": false,
  "error": "Conflict",
  "message": "This domain is already registered for this workspace.",
  "data": {
    "id": "clxx...",
    "domain": "seudominio.com",
    "status": "PENDING"
  },
  "code": "CONFLICT"
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

{
  "success": false,
  "error": "<string>",
  "message": "<string>",
  "code": "<string>",
  "details": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ],
  "data": {}
}

Autorizações

Authorization

string

header

obrigatório

Clave API sin autorización de encabezado. Ejemplo: Authorization: Bearer sk_live_xxxxx

Corpo

application/json

domain

string

obrigatório

Dominio desde el que enviará (ej.: suempresa.com o mail.suempresa.com).

Minimum string length: 1

Resposta

Dominio registrado. Configure los registros DNS devueltos y luego llame al punto final de verificación.

success

boolean

obrigatório

Exemplo:

true

data

object

obrigatório

Show child attributes

message

string

Mensaje que le indica que configure DNS y verifique la llamada.

Listar dominios de correo Consultar dominio de correo