> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get business email management link

> <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 manage your workspace's business email, including its plan, renewal, and billing.

Only the workspace owner can create the link. To set up business email you just bought, use [Get business email setup link](/api-reference/get-business-email-setup-link) instead. 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.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json post /api/billing/business-email/manage-url
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/billing/business-email/manage-url:
    post:
      summary: Get business email management link
      description: >-
        <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 manage your workspace's
        business email, including its plan, renewal, and billing.


        Only the workspace owner can create the link. To set up business email
        you just bought, use [Get business email setup
        link](/api-reference/get-business-email-setup-link) instead. 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.
      operationId: get_manage_url_api_billing_business_email_manage_url_post
      responses:
        '200':
          description: A one-time link to the business email management page.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BillingPortalLink'
              example:
                url: >-
                  https://billing.example.com/session/7c1e9f2a4b8d4e6f9a3c5b7d1e2f4a6c
        '400':
          description: This workspace has no billing account for business email.
        '401':
          description: Missing or invalid credentials.
        '403':
          description: You aren't the workspace owner, or your token is read-only.
        '429':
          description: Rate limit reached. Retry later.
        '503':
          description: >-
            Database temporarily unavailable (`database_unavailable`): the data
            cluster did not answer in time. Retry after the `Retry-After`
            seconds.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorEnvelope'
              examples:
                database_unavailable:
                  summary: database_unavailable
                  value:
                    error:
                      code: database_unavailable
                      message: Database temporarily unavailable, please retry
                      details: {}
      security:
        - PersonalAccessTokenAuth:
            - full_access
components:
  schemas:
    BillingPortalLink:
      properties:
        url:
          type: string
          title: Url
          description: >-
            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.
          example: https://billing.example.com/session/7c1e9f2a4b8d4e6f9a3c5b7d1e2f4a6c
      type: object
      required:
        - url
      title: BillingPortalLink
    StandardErrorEnvelope:
      properties:
        error:
          $ref: '#/components/schemas/StandardError'
          description: What went wrong.
      type: object
      required:
        - error
      title: StandardErrorEnvelope
      description: The error body returned in the standard envelope.
    StandardError:
      properties:
        code:
          type: string
          title: Code
          description: >-
            Stable machine-readable cause of the failure. Match on this, not on
            `message`.
          example: not_found
        message:
          type: string
          title: Message
          description: Human-readable explanation. It isn't a stable contract.
          example: App not found
        details:
          additionalProperties: true
          type: object
          title: Details
          description: >-
            Structured context for the failure, or an empty object when there's
            none.
          example: {}
      type: object
      required:
        - code
        - message
      title: StandardError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.