Pay Google Ads workspace debt
<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
Charges the workspace's card on file to settle its outstanding Google Ads balance.
<Warning>This moves money. It charges the card immediately, with no confirmation step and nothing in the request that asks a person first, so treat calling it as the approval. Read Get Google Ads workspace debt beforehand to see the amount, and only call this when a human has agreed to it.</Warning>
Read status rather than the HTTP status. Only paid, already_settled and paid_recovery_incomplete mean the balance is dealt with; every other value comes back under a 200 having charged nothing, and summary tells you why.
Retrying is safe. Base44 serializes the charge per account against the specific invoice, so two calls racing each other cannot double-charge, and a repeat call once a charge is in flight reports pending_payment instead of starting another.
The body takes no fields. Send an empty object, since anything else is rejected.
Settling clears the hold that stops campaigns serving, so a campaign paused for non-payment can resume afterwards. The summary in the response reports whether the account actually came back, which is what paid_recovery_incomplete distinguishes.
<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>
<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>
Path parameters
ID of the app whose Google Ads campaigns to manage.
ID of the app whose Google Ads campaigns to manage.
Request body
Response
What happened, and the balance afterwards.
Example response
{
"status": "paid",
"summary": {
"state": "payable",
"account_id": "68b1c0d4e7b91d003c45a1f8",
"app_id": "6820f3a4e7b91d003c45a1f2",
"account_status": "BLOCKED",
"block_reason": "PAYMENT_FAILED",
"charge_trigger_mode": "cadence",
"recoverable": true,
"can_pay_now": true,
"payment_method": {
"brand": "visa",
"last4": "4242"
},
"invoice": {
"id": "68b1c0d4e7b91d003c45a1fa",
"status": "FAILED",
"billing_type": "weekly",
"period_start": "2026-08-18",
"period_end": "2026-08-24",
"amount_micros": 43500000,
"currency_code": "USD",
"failed_at": "2026-08-25T04:12:00Z"
}
}
}Changes
No recorded changes to this endpoint across all 1 revision of this API.