Docs
E-mails

E-mails

Crie e gerencie endereços de e-mail no seu domínio.

Não abuse do serviço de e-mail. Atividade ilegal ou maliciosa pode resultar em bloqueio da conta.

Visão geral

Crie endereços no domínio da plataforma (ou no domínio configurado pelo administrador), receba mensagens e, conforme o plano, envie e-mails.

Comece em E-mails.

Como funciona

  • Envio: provedores como Resend ou Brevo, conforme a configuração do administrador.
  • Recebimento: worker de e-mail (Cloudflare) que entrega as mensagens na sua inbox.

Validade

Os endereços e as mensagens permanecem até você apagar. A exclusão de um endereço remove também a inbox — não há recuperação.

Limites

Os limites vêm do seu plano: quantidade de endereços, envios por mês e recursos extras. Confira no painel ou na página de preços.

API

Criar endereço

POST /api/v1/email

curl -X POST \
  -H "Content-Type: application/json" \
  -H "wrdo-api-key: SUA_CHAVE" \
  -d '{
    "emailAddress": "prefixo@seu-dominio.com"
  }' \
  https://seu-dominio.com/api/v1/email

O sufixo precisa ter pelo menos 5 caracteres. A chave fica em Configurações.

Respostas comuns: 401 chave inválida, 403 cota atingida, 409 endereço já existe.

Ler a inbox

GET /api/v1/email/inbox

Crie o endereço antes de consultar a inbox.

curl -X GET \
  -H "wrdo-api-key: SUA_CHAVE" \
  "https://seu-dominio.com/api/v1/email/inbox?emailAddress=prefixo@seu-dominio.com&page=1&size=10"

Parâmetros: emailAddress (obrigatório), page e size (opcionais).

Excluir endereço

DELETE /api/v1/email

curl -X DELETE \
  -H "wrdo-api-key: SUA_CHAVE" \
  -d '{
    "emailAddress": "prefixo@seu-dominio.com"
  }' \
  "https://seu-dominio.com/api/v1/email"