Criar um endereço
Cria um endereço no domínio. Recebe assim que o domínio recebe, e pode ser usado para enviar assim que o domínio puder enviar.
Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.
POST /domains/{id}/addresses
Cria um endereço no domínio. Recebe assim que o domínio recebe, e pode ser usado para enviar assim que o domínio puder enviar.
O pedido
Parâmetros
localPartstringobrigatório- A parte antes do `@`, de 1 a 64 caracteres, em minúsculas. `*` é a forma como o catch-all se escreve e não pode ser um endereço por si só.
labelstring | null- Um nome para o endereço na aplicação, com no máximo 120 caracteres.
Exemplo
Requer domains:write. Uma chave limitada a determinados endereços ou domínios tem de deter o domínio inteiro.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "localPart": "billing", "label": "Invoices" }'{ "object": "address", "id": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "address": "[email protected]", "localPart": "billing", "label": "Invoices", "enabled": true, "lastReceivedAt": null, "createdAt": "2026-09-25T10:00:00.000Z", "updatedAt": "2026-09-25T10:00:00.000Z"}Criar um endereço que foi removido traz-o de volta, ativado. Criar um que já existe volta a ativá-lo e devolve-o, e só altera a etiqueta quando enviar uma.
Com o catch-all ligado, um novo endereço começa com a assinatura e as definições que o catch-all tem.
Um endereço reservado para uma conta responde 409 address_reserved, e um espaço de trabalho no seu limite de endereços responde 422 workspace_limit_reached.
