---
title: "Create Topup"
method: POST
path: "/api/v1/openai-ads/billing/topup"
tags: ["openaiAds"]
---

# Create Topup

`POST /api/v1/openai-ads/billing/topup`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/openai-ads/billing/topup`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- TopupRequestDTO
  - `account_id` string, required
  - `amount` number, required

## Response `200`

Successful Response

- OpenAIAdsResponseDTOInvoiceDTO
  - `code` integer
  - `message` string
  - `data` InvoiceDTO, required
    - `id` string, required
    - `amount` number, required
    - `status` string, required
    - `created_at` string, nullable
    - `is_auto` boolean
    - `hosted_invoice_url` string, nullable
  - `error_code` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-13** `c7202552278d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/openai-ads/billing/topup/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)