---
title: "Get business email setup link"
method: POST
path: "/api/billing/business-email/setup-url"
---

# Get business email setup link

`POST /api/billing/business-email/setup-url`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/billing/business-email/setup-url`
- Auth: HTTP bearer

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Creates a one-time link to the page where you finish setting up business email on `domain`. Use it when [Get business email status](/api-reference/get-business-email-status) reports the domain as `PENDING_SETUP`. The page opens with the number of mailboxes you bought already filled in.

`domain` isn't checked against your subscriptions, so a domain without business email still returns a link. Check the status first.

Only the workspace owner can create the link. A read-only token is refused, and workspace API keys aren't accepted.

<Note>The link signs whoever opens it in to your workspace's billing account, and it works once. Don't share it, and create a new link each time.</Note>

Each call returns a new link and changes nothing, so retrying is safe. Limited to 6 requests a minute per caller. Some workspaces have a different limit.

## Request body

- BusinessEmailDomainPayload
  - `domain` string, required: Custom domain the business email is for, without `www.`.

## Response `200`

A one-time link to the business email setup page.

- BillingPortalLink
  - `url` string, required: Link to open in the browser of the person who acts on it. Treat it as opaque. It works once, so create a new one each time.

## Other responses

- `400`: This workspace has no billing account for business email.
- `401`: Missing or invalid credentials.
- `403`: You aren't the workspace owner, or your token is read-only.
- `422`: Validation Error
- `429`: Rate limit reached. Retry later.

## Changes

> 66 revisions in range; 1 not diffed.

- **2026-10-26** `395a6758864a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/billing/business-email/setup-url/post.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/d877a932dc19?raw)