X Ads API (Twitter Ads) for Developers

How to use the X Ads API with Zernio

1. 1.
   Enable the Ads Add-On

   Activate Ads in billing. Available on Build, Accelerate, or Unlimited Zernio plans.
2. 2.
   Connect Your X Ads Account

   OAuth flow with your X account. We handle OAuth 1.0a request signing behind the scenes.
3. 3.
   POST to /v1/ads/create

   Create campaigns, promote tweets, pull analytics. REST end-to-end.

Why Developers Choose Zernio for X Ads

Code Examples

curl -X POST "https://zernio.com/api/v1/ads/boost" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postId": "POST_ID",
    "accountId": "ACCOUNT_ID",
    "adAccountId": "18ce54d4x5t",
    "platform": "xads",
    "name": "Boost launch tweet",
    "goal": "engagement",
    "budget": { "amount": 50, "type": "daily" },
    "schedule": { "startDate": "2026-04-20", "endDate": "2026-04-27" },
    "targeting": {
      "locations": ["US", "CA", "GB"],
      "languages": ["en"]
    }
  }'

curl -X POST "https://zernio.com/api/v1/ads/create" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "xads",
    "accountId": "acc_xads_123",
    "adAccountId": "18ce54d4x5t",
    "name": "Q2 Product Awareness",
    "goal": "awareness",
    "budget": { "amount": 75, "type": "daily" },
    "schedule": { "startDate": "2026-04-20", "endDate": "2026-06-20" },
    "creative": {
      "tweetText": "Ship faster with platform engineering done right.",
      "imageUrl": "https://cdn.example.com/q2-awareness.jpg",
      "websiteCard": {
        "url": "https://example.com/platform",
        "title": "Internal Developer Platforms"
      }
    },
    "targeting": {
      "locations": ["US"],
      "languages": ["en"]
    }
  }'

See it in action

Campaigns, Line Items, and Promoted Tweets in one table.

Spend, CPE, CPM, and link-click metrics in real time.

Access X Ads API with Zernio

If a specific campaign type is blocking your integration, let us know.

Frequently Asked Questions

Is the X (Twitter) Ads API free?

└The Ads API is separate from X's regular API tiers ($200 Basic, $5,000 Pro, $42,000+ Enterprise - those cover the general X API, not ads). The X Ads API has its own approval process. Through Zernio you use a single subscription with the Ads add-on; your actual ad spend goes directly to X.

Do I need X Ads API approval?

└Not through Zernio. Direct access requires an approval application that's known to take weeks or months and reject many requests. Zernio is already approved and you use our access on your behalf.

How does X Ads API OAuth 1.0a authentication work?

└The X Ads API uses OAuth 1.0a request signing (not OAuth 2.0). Every request must be signed with a shared secret. Zernio computes signatures server-side so your integration uses a standard Bearer token.

What are the latest X Ads API updates in 2026?

└X shifted its general API to pay-per-use pricing in February 2026 and discontinued the free tier for new signups. The Ads API itself remains approval-gated with OAuth 1.0a. Zernio tracks all upstream version changes so your integration stays on a stable REST surface.

What happened to the old Twitter Ads API?

└It's still running as the X Ads API. Endpoints moved from Twitter to X but the surface is largely the same. Campaigns, promoted tweets, media upload, website cards, and analytics all continue to work.

Can I run X Ads alongside Meta, Google, and LinkedIn from one API?

└Yes. Zernio exposes a single /v1/ads endpoint where the platform parameter selects the destination (tiktokads, metaads, googleads, linkedinads, pinterestads, xads). One API key, all ad platforms - no separate SDKs per network.

Can AI agents manage X Ads through Zernio?

└Yes. Zernio's REST API and MCP server work for AI-agent use. Any tool that makes HTTP requests or connects via MCP - Claude, ChatGPT agents, n8n, Make - can create campaigns, boost tweets, and pull analytics.

Can I boost organic tweets that perform well?

└Yes. Any tweet from a connected X (Twitter) account can be promoted if the ad account has permission. Zernio-scheduled tweets are the easiest since they're already linked.

Related Features