List ad account requests
Lists the organization's requests for new Meta ad accounts made through Koast: each request's status and stage, the ad accounts it produced with their act ids, and the funds added to them.
Tool name: list-ad-account-requests.
Lists the organization's requests for new Meta ad accounts made through Koast: each request's status and stage, the ad accounts it produced with their act ids, and the funds added to them.
When to use
Use to see where an ad account request stands, to find the ad account ids a request produced before adding funds, or to check whether a payment for funds went through. Requests themselves are made in the Koast app.
Access
| Property | Value |
|---|---|
| Required scope | read |
| Publishes | No |
| Read-only | Yes |
| Destructive | No |
| Idempotent | Yes |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
cursor | string | No | Opaque cursor from the previous page's nextCursor. Omit for the first page. |
limit | integer | No | Rows per page, 1-100. Defaults to 50 when paging. Minimum 1, maximum 100. |
Output
| Field | Type | Required | Description |
|---|---|---|---|
data | object[] | Yes | |
nextCursor | string | null | Yes | Pass as cursor to read the next page. Null when there is no next page. |
REST equivalent
GET /v1/ad-account-requests, List ad account requests. CLI: koast list-ad-account-requests.
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.
Quote ad account funds
Prices adding funds to an ad account from an ad account request exactly as add-ad-account-funds would charge, without creating anything: the budget that lands on the ad account, Koast's fee, the platform location fee and the total the user pays.