Pay Google Ads workspace debt

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '{}'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now"

payload = {}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "status": "paid",
  "summary": {
    "state": "payable",
    "recoverable": true,
    "can_pay_now": true,
    "requires_payment_method": false,
    "stripe_unavailable": false,
    "account_id": "68b1c0d4e7b91d003c45a1f8",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "account_status": "BLOCKED",
    "block_reason": "PAYMENT_FAILED",
    "charge_trigger_mode": "cadence",
    "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"
    }
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Billing

Pay Google Ads workspace debt

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Charges the workspace’s card on file to settle its outstanding Google Ads balance.

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.

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.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

POST

api

apps

{app_id}

google-ads

billing

workspace-pay-now

Pay Google Ads workspace debt

curl --request POST \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '{}'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now"

payload = {}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now"

	payload := strings.NewReader("{}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/billing/workspace-pay-now")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api_key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{}"

response = http.request(request)
puts response.read_body

{
  "status": "paid",
  "summary": {
    "state": "payable",
    "recoverable": true,
    "can_pay_now": true,
    "requires_payment_method": false,
    "stripe_unavailable": false,
    "account_id": "68b1c0d4e7b91d003c45a1f8",
    "app_id": "6820f3a4e7b91d003c45a1f2",
    "account_status": "BLOCKED",
    "block_reason": "PAYMENT_FAILED",
    "charge_trigger_mode": "cadence",
    "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"
    }
  }
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

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.

Show child attributes

Overview

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Pay Google Ads workspace debt

Authorizations

Path Parameters

Body

Response