Pay Google Ads workspace debt

Changed on

<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>

post/api/apps/{app_id}/google-ads/billing/workspace-pay-now

Request

  • Base URL
    https://app.base44.com
  • URL
    https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now
  • Auth
    HTTP bearer

Path parameters

app_idstring required

ID of the app whose Google Ads campaigns to manage.

Request body

object required

Response

What happened, and the balance afterwards.

statusstring 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 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