Email

Connect an inbox by forwarding

Creates a connected mailbox at the inbox's own address and answers with a forwarding address on the platform's forwarding domain, with the steps for Gmail, Outlook and other providers. Add a forwarding rule at the provider; what arrives at that address is unwrapped (original sender, date, subject) and stored under the connected mailbox. Gmail asks the forwarding address to confirm: the code and the link appear on the connection. The first mail that comes back, or a probe (POST /api/emails/{address}/connector/verify), makes the connection active. Only new mail arrives this way; older mail cannot be imported. Requires email:write. The forwarding domain must be configured on the server.

post/api/emails/connect/forwarding

Request

  • Base URL: https://domani.run
  • URL: https://domani.run/api/emails/connect/forwarding
  • Auth: HTTP bearer

Request body

addressstring required

The inbox to connect, for example someone@gmail.com

workspace_idstring

Workspace the mailbox belongs to; your personal workspace by default

Response

The forwarding address and the steps

addressstring required
mailbox_idstring required
status'pending' | 'active' required
forwarding_addressstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.