---
title: "Adjust an advertising account's non-purchased funds"
method: POST
path: "/v1/admin/ads/accounts/{account_id}/adjust"
tags: ["Operations"]
---

# Adjust an advertising account's non-purchased funds

`POST /v1/admin/ads/accounts/{account_id}/adjust`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/admin/ads/accounts/{account_id}/adjust`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-LOPPEE-API-Key`

Adjust an advertising account's non-purchased funds. The response is scoped and validated by the runtime repository; unknown or unauthorized resources use the canonical error envelope.

## Path parameters

- `account_id` string, required

## Request body

- object
  - `amount_cents` number, required: Whole cents, non-zero, at most 1,000,000 either way; a promotional credit is positive.
  - `kind` 'promo_credit' | 'admin_adjustment', required
  - `reason` string, required
  - `expires_at` string: Promotional credit only: ISO date-time 1 hour to 2 years ahead, disclosed to the owner.
  - `idempotency_key` string

## Response `200`

Adjust an advertising account's non-purchased funds response

- object: Audited promotional credit or adjustment of non-purchased (not card-refundable) funds. Purchased funds are never created or removed here. Requires manage_billing.

## Other responses

- `400`: ErrorResponse
- `401`: ErrorResponse
- `403`: ErrorResponse
- `404`: ErrorResponse
- `409`: ErrorResponse
- `413`: ErrorResponse
- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)
