HeartBeatAgents

X Ads

View as Markdown

Manage X/Twitter advertising campaigns: campaigns, line items, and promoted tweets.

What it does

Connects an agent to the X Ads API. Agents can list and create campaigns, pull analytics, and manage audiences and creatives.

Setup

  1. Go to Settings → Integrations → X Ads.
  2. Click Connect and authorize via OAuth 2.0. This shares the same underlying app connection as the regular X integration.
  3. Choose which ad account the agent can manage.
  4. Assign the connection to an agent.

Scopes requested

Read access to tweets and your profile, plus read/write access to ads, with offline access so the connection keeps working without you having to sign in again.

Typical use

An agent that pulls a campaign's performance and summarizes it for you, or one that reports which creative is performing best across your active campaigns.