Add ad account funds
Starts adding funds to an ad account from an ad account request: prices the budget plus Koast's fee and the platform location fee, and returns the payment page (checkoutUrl) the user must open to pay.
Tool name: add-ad-account-funds.
Starts adding funds to an ad account from an ad account request: prices the budget plus Koast's fee and the platform location fee, and returns the payment page (checkoutUrl) the user must open to pay. Nothing is charged until they pay there, and the funds reach the ad account once the payment is received.
When to use
Use when the user asks to add funds or budget to an ad account Koast created for them. Quote it first with quote-ad-account-funds and confirm the total with the user, then give them the checkoutUrl. Never open or pay it for them.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | No |
| Idempotent | No |
| Open world | Yes |
Input
| Field | Type | Required | Description |
|---|---|---|---|
requestId | string | Yes | The ad account request id, or its Koast reference (KST-…). At most 40 characters. |
adAccountId | string | Yes | The ad account to fund, act_…: one of the request's accounts. At most 40 characters. |
budgetCents | integer | Yes | The budget to land on the ad account, in cents of the request's currency. Koast's fee and the platform location fee are added on top of it. |
paymentMethod | string | Yes | How the customer pays: card, bank_transfer (a US bank transfer, USD accounts only) or crypto (USDC, USD accounts only, when Koast offers it). Koast's fee depends on it. One of card, bank_transfer, crypto. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
topUp | object | Yes | |
checkoutUrl | string | Yes | The payment page. The user opens it to pay; nothing is charged until they do. It expires after 24 hours unpaid. |
REST equivalent
POST /v1/ad-account-requests/{requestId}/top-ups, Add ad account funds. CLI: koast add-ad-account-funds.
Choose where deposits go
Chooses the ad account the organization's bank transfers and stablecoin deposits are added to, and returns the funding details.
Get ad account request
Reads one ad account request by its id or its Koast reference (KST-…): its status, the six-stage timeline with when each stage was reached, the ad accounts it produced and every top-up.