byo-domains

Request mailboxes Coldrig sets up on an already-active BYO domain.

Changed on

The primary build target: the vendor sets up new mailboxes under the customer's own domain, reusing the same setup path as the lookalike-domain flow. Requires the domain to already be active (past DNS verification). These are mailboxes Coldrig sets up, so they count toward the standard per-mailbox quantity billing ($5 a month for each mailbox past the first 3); pass quoteOnly: true to preview the new count + projected monthly before setup.

post/byo-domains/{id}/managed-mailboxes

Request

  • Base URL: https://api.coldrig.dev
  • URL: https://api.coldrig.dev/byo-domains/{id}/managed-mailboxes
  • Auth: HTTP bearer

Path parameters

idstring required

The MCP tools get_byo_domains and configure_byo_domain take this same identifier as an id argument (there is no URL path in MCP tool calls).

Request body

countinteger required

At most 5; on a live account, a domain with no managed mailboxes needs 3-5.

personaSlugstring

Optional; defaults to a slug of the domain.

quoteOnlyboolean

Quote-before-add — true previews the new count + projected monthly without setup.

Response

Mailboxes set up.

mailboxEmailsstring[] required

Changes

  • 242a462d82c4Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the success response with the status