List ad account changes
Lists the changes asked for on the organization's ad accounts, newest first: optionally only those of one request (requestId, its id or its KST-… reference) or in one status. Each carries what was asked (label), its status, and the reason it was refused. A key limited to specific brands is refused with 403 brand_not_allowed: requests belong to the whole organization.
bearerAuthAuthorizationBearer <token>An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.
requestId?stringOnly the changes of this request: its id, or its Koast reference (KST-…).
1 <= length <= 40status?stringOnly the changes in this status.
"open""info_requested""done""refused""cancelled"List ad account changes
application/json- response
changes*array<>Newest first.
curl -X GET "https://example.com/v1/ad-account-requests/changes" \ -H "Authorization: Bearer koast_sk_..."{ "changes": [ { "id": "string", "requestId": "string", "adAccountId": "string", "kind": "rename", "status": "open", "label": "string", "reason": "string", "askedAt": "string", "decidedAt": "string", "acknowledged": true, "cardLast4": "string" } ]}Required scope: read. CLI: koast list-ad-account-changes, see Ad Account Requests commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.
List ad account requests
Lists the organization's ad account requests, newest first. Cancelled requests are not listed. Each request carries its stage (1 request sent, 2 business verified, 3 ad account created, 4 shared into your Business Manager, 5 connected in Koast, 6 funds added), the ad accounts it produced (act_…) and every top-up with its payment status. Requests are made in the Koast app, where the business documents are uploaded, and Koast reviews each one before sending it on: awaitingReview is true until then. A key limited to specific brands is refused with 403 brand_not_allowed: requests belong to the whole organization.
Get ad account request
Returns one ad account request of the organization, by its id or its Koast reference (KST-…), with the timeline of its six stages, the ad accounts it produced and every top-up. Another organization's request answers 404.