X Ads

curl -X POST "https://api.sb/leaseline.app/campaigns/create?mode=try" \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"venue":"x","objective":"engagement","promote":"posts/x-late-rent-thread","budget":{"amount":100,"currency":"USD","per":"test"},"audience":{"followersOf":8}}'

npx startup-builder do Campaign.create --try --data '{"venue":"x","objective":"engagement","promote":"posts/x-late-rent-thread","budget":{"amount":100,"currency":"USD","per":"test"},"audience":{"followersOf":8}}'

{
  "name": "do",
  "arguments": {
    "mode": "try",
    "code": "return await $.Campaign.create({ venue: 'x', objective: 'engagement', promote: 'posts/x-late-rent-thread', budget: { amount: 100, currency: 'USD', per: 'test' }, audience: { followersOf: 8 } })"
  }
}

import { $ } from 'startup-builder'

const result = await $.try.Campaign.create({ venue: 'x', objective: 'engagement', promote: 'posts/x-late-rent-thread', budget: { amount: 100, currency: 'USD', per: 'test' }, audience: { followersOf: 8 } })

 1{
 2  "$type": "Campaign",
 3  "mode": "try",
 4  "stored": false,
 5  "venue": "x",
 6  "promoting": "posts/x-late-rent-thread",
 7  "organic": {
 8    "replies": 14,
 9    "impressions": 3200
10  },
11  "budget": {
12    "amount": 100,
13    "currency": "USD",
14    "days": 5
15  },
16  "readAt": "5,000 impressions",
17  "runsBy": "browser",
18  "steps": 14
19}

Connect onceCopy Anchor Link

1. Call Integration.connect with system: 'ads' and venue: 'x'; a browser window opens on X Ads.
2. Sign in with the X account you post from; the session is saved to your browser profile.
3. Set the spend on your standing approval with Mandate.authorize; X bills your ad account, never the platform.

What your agents doCopy Anchor Link

Calls on your own account are free; X bills your spend directly.

Reading this site’s public data needs no account: Keyword.search is a Data call (the three ways a call runs).

What it holdsCopy Anchor Link

Events and webhooksCopy Anchor Link

Any Event can wake a Workflow, and a Watch delivers it to your endpoint, signed (Events and webhooks).

LimitsCopy Anchor Link

Start hereCopy Anchor Link

Field mapCopy Anchor Link

What try does hereCopy Anchor Link

Returns the promotion as X Ads will hold it, with the steps the browser agent would take; no session opens and nothing is promoted.

How long a connection lastsCopy Anchor Link

A connection lasts as long as the site keeps your saved session signed in; the platform checks the session before every run.

The platform asks you to reconnect 7 days before it runs out; until you do, a call that needs it refuses with needs-reauth.

FormatsCopy Anchor Link

Plays and strategiesCopy Anchor Link

Used byCopy Anchor Link

No Workflow, agent task or Service acts through it yet: your agents call it directly.

ReferenceCopy Anchor Link

3 calls, each with its path and price

Call	Path	Price
Campaign.create	POST /campaigns/create	About 1.6¢ a step
Campaign.update	POST /campaigns/update	About 1.6¢ a step
Metric.query	POST /metrics/query	About 1.6¢ a step