# Purchase add on mailboxes

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v2/wallet/buy-addon-mailboxes:
    post:
      summary: Purchase add on mailboxes
      deprecated: false
      description: >
        The Mailbox Add-on Public API allows users to purchase additional
        mailboxes beyond their base plan allocation using their wallet balance.


        Price per mailbox - 


        | Plan Tier | Monthly | Quarterly | Yearly |

        |----------|---------|-----------|--------|

        | Starter  | $3.50   | $9.75     | $39.00 |

        | Growth   | $3.25   | $9.00     | $33.00 |

        | Pro      | $3.00   | $8.10     | $30.00 |
      tags:
        - payments & wallet
      parameters:
        - name: quantity
          in: query
          description: ''
          required: true
          example: '1'
          schema:
            type: string
        - name: x-auth-zapmail
          in: header
          description: ''
          required: true
          example: ''
          schema:
            type: string
        - name: x-workspace-key
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
        - name: x-service-provider
          in: header
          description: ''
          required: false
          example: ''
          schema:
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  paymentLink:
                    type: string
                required:
                  - message
                  - paymentLink
                x-apidog-orders:
                  - message
                  - paymentLink
              example:
                message: >-
                  Mailbox purchase is processed successfully and invoice is
                  created. https://invoice.stripe.com/i/acct_1xxxxxxp
                paymentLink: https://invoice.stripe.com/i/acct_xxxxxx/test_xxxxxxx
          headers: {}
          x-apidog-name: Success
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
                x-apidog-orders:
                  - message
              example:
                message: quantity is required
          headers: {}
          x-apidog-name: Bad Request
        '401':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
                x-apidog-orders:
                  - message
              example:
                message: Invalid Key
          headers: {}
          x-apidog-name: Unauthorized
        '403':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
                x-apidog-orders:
                  - message
              example:
                message: >-
                  You are not permitted to perform this action, please contact
                  support
          headers: {}
          x-apidog-name: Forbidden
        '404':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
                x-apidog-orders:
                  - message
              example:
                message: Workspace not found
          headers: {}
          x-apidog-name: Not Found
        '500':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
                x-apidog-orders:
                  - message
              example:
                message: No price found for {plan_name}
          headers: {}
          x-apidog-name: Internal Server Error
      security: []
      x-apidog-folder: payments & wallet
      x-apidog-status: released
      x-run-in-apidog: https://app.apidog.com/web/project/797058/apis/api-26273085-run
components:
  schemas: {}
  securitySchemes: {}
servers:
  - url: https://api.zapmail.ai/api
    description: Prod Env
security: []

```