Skip to main content
POST
Pay Google Ads workspace debt

Authorizations

Authorization
string
header
required

Personal access token, sent as Authorization: Bearer <token>. Each operation lists the permission it needs: read_only or full_access. A full-access token can call every operation. A read-only token can call only the operations that list read_only; anything else returns 403 read_only_credential_route_not_allowed.

Path Parameters

app_id
string
required

ID of the app whose Google Ads campaigns to manage.

Body

application/json

The body is of type PayWorkspaceDebt · object.

Response

What happened, and the balance afterwards.

The outcome of settling the workspace's ad-spend balance.

status
string
required

What happened. paid means the card was charged and the balance is settled. pending_payment means a charge was already in flight, so nothing new was attempted. already_settled means the invoice turned out to be paid and the account is back to normal, and paid_recovery_incomplete means it is paid but the account is still held. Anything else is the state from the summary, meaning no charge was attempted: no_debt, not_recoverable, requires_payment_method, requires_payment_refresh, or unavailable. Read this rather than the HTTP status, which is 200 for every one of them.

Example:

"paid"

summary
WorkspaceDebtSummary · object
required

The balance as it stands after the attempt, in the same shape Get Google Ads workspace debt returns. Read it back to confirm what actually changed.