{
  "schemaVersion": "1.0",
  "item": {
    "slug": "x-ads",
    "name": "X Ads",
    "category": "sales-and-marketing",
    "description": "X Ads issues an invoice for each billing period and stores documents in the ad account's billing history.",
    "status": "researched",
    "website": "https://business.x.com/",
    "invoiceHelpUrl": "https://business.x.com/en/help/account-setup/billing-basics/billing-invoices",
    "accessMethods": [
      "vendor_portal",
      "email_forward",
      "manual_upload"
    ],
    "authentication": {
      "oauth": false,
      "apiToken": false,
      "browserSession": true,
      "requiredRole": "X Ads account user with billing access"
    },
    "capabilities": {
      "accountDiscovery": {
        "supported": false,
        "notes": "No public workflow for discovering every account from billing data is documented."
      },
      "billingHistory": {
        "supported": true,
        "notes": "Billing records are documented at X Ads > Billing > Billing history."
      },
      "invoiceMetadata": {
        "supported": true,
        "notes": "Issued billing records include the core details needed to identify the charge."
      },
      "invoicePdf": {
        "supported": true,
        "notes": "The documented workflow provides PDF invoice, billing history."
      },
      "creditNotes": {
        "supported": "unknown",
        "notes": "Credit-note availability is not confirmed by the reviewed source."
      },
      "lineItems": {
        "supported": "partial",
        "notes": "Line-item depth varies by document type, plan, or contract."
      },
      "usage": {
        "supported": true,
        "notes": "The vendor documents usage detail alongside its billing workflow."
      },
      "subscriptions": {
        "supported": false,
        "notes": "The documented charges are usage or transaction based, not subscriptions."
      },
      "paymentMethod": {
        "supported": true,
        "notes": "The documented billing area includes payment-method management or detail."
      }
    },
    "billing": {
      "cadence": [
        "threshold-based",
        "billing-period based"
      ],
      "invoiceLocation": "X Ads > Billing > Billing history",
      "emailedAutomatically": "unknown",
      "currencies": [],
      "documentTypes": [
        "invoice",
        "receipt"
      ]
    },
    "billproof": {
      "retrieval": false,
      "normalization": true,
      "transactionMatching": true,
      "connectionAvailable": false,
      "limitations": [
        "Billproof does not currently have a direct X Ads billing connection.",
        "Retrieval requires an authorized user to download or forward the document."
      ]
    },
    "normalizedFields": [
      "vendor_name",
      "invoice_number",
      "invoice_date",
      "billing_period",
      "subtotal",
      "tax",
      "total",
      "currency",
      "payment_method",
      "account_id"
    ],
    "commonCardDescriptors": [],
    "researchedAt": "2026-08-29",
    "lastVerifiedAt": "2026-08-29",
    "sources": [
      {
        "title": "X Ads billing invoices",
        "url": "https://business.x.com/en/help/account-setup/billing-basics/billing-invoices",
        "type": "official"
      }
    ],
    "guide": {
      "quickAnswer": "Open ads.x.com, select the ad account, go to Billing > Billing history, and download the invoice for the charge.",
      "requiredRole": "X Ads account user with billing access",
      "steps": [
        "Sign in to X Ads Manager and select the billed ad account.",
        "Open the profile menu and choose Billing.",
        "Open Billing history and locate the billing period.",
        "Open or download the invoice PDF."
      ],
      "historyLocation": "X Ads > Billing > Billing history",
      "missingInvoice": "Confirm an authorized payment card is attached, the correct ad account is selected, and at least 48 hours have passed since the charge.",
      "formats": [
        "PDF invoice",
        "billing history"
      ],
      "commonProblems": [
        "The ad account has no authorized card on file.",
        "The invoice is searched before it is issued after the charge."
      ],
      "matchingTips": [
        "Match ad account, invoice number, billing period, currency, and total.",
        "Use daily campaign-spend lines to explain threshold-triggered charges."
      ]
    },
    "statusLabel": "Billing guide available",
    "cta": "Request this integration",
    "manualGuide": null,
    "urls": {
      "html": "https://billproof.io/integrations/x-ads",
      "json": "https://billproof.io/api/public/vendors/x-ads.json",
      "capabilities": "https://billproof.io/api/public/vendors/x-ads/capabilities.json"
    }
  }
}