---
title: "Changes to Create a top-up"
method: POST
path: "/v1/balance/top-ups"
---

# Changes to Create a top-up

`POST /v1/balance/top-ups`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 182 revisions.

- **2026-10-29** `dbfaa35515ac`: 3 breaking, 8 warning, 18 info
- **2026-10-28** `8f2c44dd7550`: 1 info

## Changes

- **2026-10-29** `dbfaa35515ac`: 3 breaking, 8 warning, 18 info
  - the response property `code` became optional for the status `402`
  - the response property `error` became optional for the status `402`
  - removed the required property `reason` from the response with the `402` status
  - removed the optional property `dashboard_url` from the response with the `402` status
  - removed the optional property `details/current_account_count` from the response with the `402` status
  - removed the optional property `details/effective_account_limit` from the response with the `402` status
  - removed the optional property `details/free_tier_account_limit` from the response with the `402` status
  - removed the optional property `details/has_payment_method` from the response with the `402` status
  - removed the optional property `details/verification_amount_cents` from the response with the `402` status
  - removed the optional property `documentation_url` from the response with the `402` status
  - removed the optional property `url` from the response with the `201` status
  - added the new optional request property `paymentMethodId`
  - added the non-success response with the status `404`
  - added the optional property `details/adAccountId` to the response with the `402` status
  - added the optional property `details/budgetScope` to the response with the `402` status
  - added the optional property `details/createdObjects` to the response with the `402` status
  - added the optional property `details/quotaExhausted` to the response with the `402` status
  - added the optional property `details/quotaScope` to the response with the `402` status
  - added the optional property `details/stage` to the response with the `402` status
  - added the optional property `details/unconfirmedWrite` to the response with the `402` status
  - added the optional property `docUrl` to the response with the `402` status
  - added the optional property `param` to the response with the `402` status
  - added the optional property `platform` to the response with the `402` status
  - added the optional property `platformError` to the response with the `402` status
  - added the optional property `type` to the response with the `402` status
  - the response property `topupId` became required for the status `201`
  - removed the `PAYMENT_REQUIRED` enum value from the `code` response property for the response status `402`
  - added the required property `clientSecret` to the response with the `201` status
  - added the required property `status` to the response with the `201` status
- **2026-10-28** `8f2c44dd7550`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/zernio/apis/zernio-api/docs/v1/balance/top-ups/post.md) - [API](https://skmtc.dev/zernio/apis/zernio-api.md) - [Page](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/balance/top-ups/post)