Meta Ads / API Reference
meta_ads_check_payment_errors
Meta Ads tool. Check if a Meta Ads account has any active payment errors or billing issues. Inspects account status codes and payment method statuses to detect: - Unpaid debt (UNSETTLED / status 3) - Declined payment methods - Expired cards - Grace period warnings - Blocked accounts due to non-payment (status 101) Args: account_id: Ad account ID. Leave blank to use the default account. Returns a structured JSON with has_payment_error, severity (ok/warning/critical), account_status details, payment methods list, and a recommendation in Hebrew.
This is a read-only tool: it checks payment errors from your Meta Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Check payment errors in my Meta Ads account.
It takes 0 required and 1 optional parameter.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | No | Account Id |
Related Meta Ads tools
meta_ads_check_permissionsmeta_ads_ab_test_resultsmeta_ads_account_change_historymeta_ads_account_diagnosticsmeta_ads_account_spending_limitmeta_ads_ad
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: