Torvex

Report the outcome of one claimed Facebook command: ok=true marks it done and updates the local campaign / adset / ad mirror; ok=false with final=true (Graph refused it) marks it failed and alerts the profile owner, final=false (transport failure) puts it back for another attempt.

Apply a flow scheme to a campaign: REPLACES the campaign's whole routing tree with a copy of the scheme's flows and adopts its rotation settings. Later scheme edits don't propagate. Use list_flow_schemes to find the scheme id.

Attach an auto rule to a campaign (idempotent). The rule starts evaluating that campaign on its next sweep.

Block placements (source ids) on an API-type campaign — mirrored to the ad network best-effort. The blacklist is created automatically on first use. Up to 100 sites per call.

Lease the Facebook writes Torvex queued for the tokenless (browser-extension) Meta profile of a logged-in FB user — pause / resume and daily-budget changes decided by the campaign list, an Auto Rule or a rollback, comment moderation (hide / delete / reply) and the raw Graph requests of an autolaunch (graph_call / graph_upload with a signed media_url, handed out once) for cabinets with no Graph token. What the Torvex browser extension polls every minute; each command must be performed in the Ads Manager session and acknowledged with ack_meta_command. A claimed command is leased for 10 minutes, then handed out again (3 attempts); unclaimed commands expire after 24 h and alert the profile owner.

Duplicate a campaign with its whole routing tree, pixels, postbacks, tags and backup domains. The copy is a plain manual campaign with a fresh alias and starts PAUSED unless status=active is given. Blocked (422 domain_problem) while the source domain is flagged by monitoring.

Create an affiliate network. Only name is required; click_id_param (the query parameter the network expects the click id in) defaults to click_id.

Create an auto rule: conditions over campaign metrics for a time window, checked every run_every_minutes, firing an action. Campaign-level actions: pause_traffic, resume_traffic, increase_bid, decrease_bid, notify. Placement-level actions (evaluated per source_id): block_zone, whitelist_zone, unblock_zone, increase_zone_bid, decrease_zone_bid. Bid actions need action_params.bid_step and an API (or DSP) campaign. campaign_ids attaches it right away — a rule only runs on attached campaigns.

Create a manual tracker campaign. Only name is required — domain defaults to the workspace default, cost model to none, rotation to by_position. Give offer_id (and optionally landing_id) to build the default flow with that single destination, or send a full flows tree (flows → rules → destinations; see get_campaign include=flows for the shape). Returns the campaign with its click_url.

One click from an Ads Manager row: create a tracker campaign named after the Facebook campaign (manual type, the workspace's Meta traffic source, the healthy default domain, a default flow with no destination yet) and link the FB campaign to it under the tokenless profile of the logged-in FB user. Returns the campaign, its click URL (put it in the ad) and the editor URL; needs the campaigns.create permission and counts against the plan's campaign cap.

Save a creative into the Creatives Library — the one-click 'Save to Torvex' of the browser extension (Facebook Ad Library, the FB / Instagram feed, TikTok Creative Center, Ads Manager) and the API twin of the library's upload form. Media arrive as public URLs (media_urls, fetched server-side — images and MP4 / MOV / WebM video, 100 MB each, up to 10) and the ad copy as title / body / description / cta; source, source_url, advertiser and external_id (the site's own ad id, e.g. the Ad Library ID) record where it came from — a second save with the same external_id returns the existing creative (duplicate=true). Needs the creatives manage permission.

Add a tracking domain. type=system (default) assigns a free random subdomain that works immediately. type=custom connects a domain the user owns: a DNS zone is created and the response's ns_servers must be set at the registrar before the domain verifies. Buying a domain is panel-only.

Create a reusable flow scheme (a routing tree that can be applied to campaigns). Send flows as for a campaign: [{name, is_default, match: all|any, rules: [{field, operator, value}], destinations: [{type, offer_id|landing_id|…, weight}]}].

Create an entity group (groups are per entity type: campaigns, offers, landings, flow_schemes, pixels, auto_rules, traffic_sources, aff_networks, …). Name must be unique within the type.

Create a landing: a URL-type landing (an external page; {offer_url} and other macros are substituted in links — name and url required) or, with type game, a game landing rendered from a game pack (name and game_pack_id required; game_settings keys come from list_game_packs). Uploaded landings need a zip and are panel-only.

Create an offer. Only name is required — payout_type defaults to Auto (the payout comes with the postback, no planned amount), status to active. Use {click_id} and other {macros} in the URL. payout is in payout_currency (default USD); incoming postbacks without a currency parameter are converted from it. A local offer (dest_kind local) is a page the tracker hosts: pass its ZIP (with index.html at the root) as zip_base64.

Create a conversion pixel (facebook_capi, tiktok_events, google_ga4, google_ads, moloco, reddit_capi, twitter_capi, snapchat_capi, pinterest_capi, bigo_events, kwai_events). config holds the platform settings: facebook_capi {pixel_id, access_token}, tiktok_events {pixel_id, access_token}, google_ga4 {measurement_id, api_secret}, google_ads {customer_id, conversion_action_id, login_customer_id?, client_id, client_secret, refresh_token, consent?} (offline click conversions via the Data Manager API), moloco {platform_id, api_key}, reddit_capi {account_id, access_token}, twitter_capi {pixel_id, consumer_key, consumer_secret, access_token, access_token_secret, event_id?} (event mapping values are X event ids), snapchat_capi {pixel_id, access_token}, pinterest_capi {ad_account_id, access_token}, bigo_events {pixel_id}, kwai_events {pixel_id, access_token}. Secrets are write-only.

Create a workspace tag (one shared pool across entity types). Colour is picked from the fixed palette at random when omitted.

Create a traffic source. Only name is required. template_id copies the provider, API capabilities and default parameter mapping from a platform template (list_traffic_source_templates); mapping fields given explicitly override it. For API-backed templates the api_key is verified live (422 invalid_api_key). Without a template the source is custom (no network API).

Permanently remove one media file from a creative (by media id from get_creative). Future auto-launches will no longer include it; ads already created on the network are untouched.

Detach an auto rule from a campaign.

One affiliate network: click-id parameter, extra URL params, postback URL template, postback IP whitelist, notes, group and tags.

One auto-rule with its conditions, action, schedule and attached campaigns (incl. each pair's last run result).

The token owner's wallet + referral balance (USD).

One campaign by numeric id. Set include to pull the routing tree (flows with rules and destinations), attached pixels, postbacks and creatives.

Current placement (source id) blacklist of an API-type campaign.

Pre-launch check of one campaign: is it ready for real traffic? Checks status, tracking domain health, routing completeness, paused offers/landings in routing, click id reaching offer URLs, postbacks received (30 days), pixel/postback back to the traffic source, cost model and a test click (30 days). ready=false when any check has status fail; warn is advisory.

One click's full story: the scored hit row with decoded fingerprint flags, plus every conversion registered on it.

Cohort & LTV analytics. A cohort is everything that entered on the same day (or week): subject=clicks follows a traffic day — cumulative LTV/ROI per click, repeat conversions and how much of the payoff had landed by day N, with revenue attributed back to the day of the CLICK (standard reports attribute it to the day the conversion arrived); subject=registration follows sign-ups (Lead) to their deposits; subject=ftd follows first deposits (Sale) to their redeposits (Upsell) — the deposit / repeat-purchase vocabulary: summary.arpu = LTV per FTD, returns_per_entity = redeposits per FTD, active_rate = FTD→redeposit rate, summary.ladder = LTV earned inside D0 / D1-7 / D8-30 / D31-90, life_days = redeposits by day of life; subject=push follows a subscriber base; subject=pwa follows PWA installs. split_by returns a second table whose rows are one dimension value instead of a day (each row carries its own ladder, active_rate and returns_per_entity — the channel comparison). Cells a cohort has not reached yet are null.

One creative with its ordered media list. Each media row carries a 1-based position — Meta auto-launch ad #N uses the media at position N (as of launch time).

One tracking domain with health / monitoring state, nameservers (custom domains), crawler policy and default-page settings.

One flow scheme with its full flows JSON tree (rules, destinations, rotation).

One landing with its URL, push-collection and heatmap settings, notes, group and tags.

Who this token belongs to: user, resolved workspace, all addressable workspaces (for the X-Workspace-Id header) and the token abilities.

Tracker metrics keyed by FACEBOOK ids — the 'Torvex columns' the browser extension draws under every Ads Manager row: clicks, uniques, leads, approvals, hold, revenue, cost, profit, ROI, EPC, CR per FB campaign / ad set / ad id (the conversions an ad blocker hides from the Pixel). Grouped by the dimension the Meta source template fills ({{campaign.id}} → ad_campaign, {{adset.id}} → sub2, {{ad.id}} → creative), restricted to the given ids; catalog lists the cabinet's mirrored names at that level for name → id matching.

Full offer detail: destination settings (redirect/action), conversion cap with its current usage (cap_used), languages, notes.

One pixel with its platform config (secret keys such as access tokens come back as an empty string when set), value settings, group and tags.

Web-push post-click attribution: conversions (regs = Lead, ftds = Sale, redeps = Upsell) attributed to push clicks (anchor=click, default) or push shows (anchor=show) that preceded them by at most window hours (1–720, default 24; last-touch — the latest anchor of the same subscriber wins). Returns the period summary with rates (reg_rate / ftd_rate per anchor, ctr, epc = revenue per anchor), % changes vs the previous period, a daily series, one row per mailing and the cumulative conversion-lag curve (share of attributed conversions that landed within N hours). A conversion is linked to a subscriber either through a tracker link the notification opened (/c/… — the click carries the push marker) or through the click the subscription was collected on.

Web-push subscription counters: total, active, new / unsubscribed in the last 7 days.

PWA install cohorts & retention: per-cohort day-N (or week-N) retention matrix, aggregate retention/LTV curve, DAU/WAU/MAU, open rate, CPI/ARPU/ARPPU. Cohorts = PWA installs in the period; opens are followed up to today. Cells for days a cohort has not reached yet are null.

Drill-down report: group by one or more dimensions; rows come back for the dimension at level (0-based), path carries the parent row keys when drilling deeper. Every row has key, label and the full metric set. compare=true adds the previous period (same length right before; the previous calendar month for this_month/last_month): each row gets prev (its metrics then, null = no traffic then) — date/week/month rows are matched to the same position in the previous window (22 Sep vs 15 Sep for 7days), drill-down paths are translated the same way — plus prev_totals and prev_range. The basis for "what changed / what dropped vs last week" questions.

One site list with its full sites / zones / IPs values.

Aggregated analytics for a period: clicks, unique clicks, conversions, cost, revenue, profit, ROI and derived metrics. Optionally grouped by one dimension.

The organization's plan, seats, billing period and expiry.

One traffic source with its parameter mapping (which incoming query params carry source_id, zone_id, cost, sub1…), postback settings and postback URLs. The API key is never returned (has_api_key says whether one is stored).

Import up to 100 conversions by click_id, exactly as if the affiliate network had postbacked them. transaction_id is the idempotency key per click + type (the same one again reports 'duplicate', a new one is a distinct conversion even for a one-per-click type). Repeats without it follow the type's duplicate policy (Tracker → Conversion types): book again, update the existing conversion, or book as another type (a second sale as upsell — the result then carries reclassified_from). Per-item results: created / updated / duplicate / blocked / not_found / error.

Book Google Ads daily spend into click costs — the rows the Torvex Google Ads Script reads inside the advertiser's own account (one row per day × Google campaign × ad group). Google campaigns are matched to tracker campaigns by the {campaignid} ValueTrack parameter carried on the clicks themselves (a Google campaign feeding several tracker campaigns is split by click share), with the '(TID: N)' campaign-name marker as fallback; unmatched ones are reported back. Non-USD accounts are converted at the current rate; a request must carry every row of a Google campaign for the days it covers (a day is set, not incremented).

Book Facebook (Meta) daily spend into click costs WITHOUT a Graph token — the rows the Torvex browser extension reads from a logged-in Ads Manager session (one row per day × FB campaign × ad set). FB campaigns are matched to tracker campaigns via launches, manual links or the '(TID: N)' name marker; unmatched ones are reported back. USD cabinets only; a request must carry every row of a FB campaign for the days it covers (a day is set, not incremented).

Link one Facebook campaign to an existing tracker campaign (manual or meta type) under the tokenless profile of the logged-in FB user — the cost sync books its spend from the next run, the Ads Manager overlay and the status mirror pick it up at once. Idempotent per (campaign, FB id).

List affiliate networks (id, name, offer count).

Workspace audit log: who changed what.

Auto-rule firing log, newest first: every run that changed something (status applied / rolled_back) or had a network write refused (failed) — the condition verdicts behind it, the placements / bids / status it touched and whether it can still be rolled back (rollback itself is panel-only). "Conditions not met" runs are not logged; the rule keeps each attached campaign's last result (last_result) instead.

The auto-rule library (scheduled campaign-optimization rules).

List tracker campaigns (paginated, newest first). Each row has id, name, alias, type, status, traffic source, domain and click URL.

Saved network-upload presets (campaign setups).

Raw click rows, newest first, cursor-paginated: each response carries next_cursor for the following page (null on the last page). Bots included unless exclude_bots.

Raw conversion rows (leads, sales, rejects, upsells), newest first, cursor-paginated (next_cursor, null on the last page).

Country ISO codes and names (for offer targeting).

Creatives Library entries (paginated). Rows include format, folder, media count.

Active currencies with their USD rates. All stored amounts are USD.

DNS providers (names only; API keys are never returned).

Domain registrars (names only; API keys are never returned).

List tracking domains with health state (problem: gsb_blocked / no_dns / unreachable / ssl_error / null).

Inbound DSP bid request log.

DSP configuration (inbound API keys are never returned).

Flow schemes (reusable routing trees).

Game packs (playable wheel / slot / crash templates) available to the workspace: id, slug, name, collection, game_type, whether it is the workspace's own upload, the editable settings schema (key, label, default, group, type, options) and the preview image. A pack id is what create_landing with type game takes.

Entity groups (per entity type).

List landings (paginated). Rows include type (url / uploaded / AI-generated with its generation status / game) and language.

Per-network pixel lead-type values (e.g. facebook Purchase, kwai EVENT_CHECKOUT).

Meta (Facebook) accounts with health state and mirrored ad accounts (balances, spend). Tokens are never returned.

The workspace's Meta agencies — id, name, commission percent, active flag — the picker behind register_meta_cabinet's agency_id (what the Torvex browser extension shows in its settings after the workspace). Inactive agencies are flagged, not hidden, so a saved pick keeps resolving.

Mirrored comments on active Meta ads.

Meta campaign launch history with status, result and errors.

What the given Facebook campaign ids are linked to in the tracker (campaign_meta_links — the campaign editor's Facebook picker rows) plus the manual / meta tracker campaigns a link can point at (q narrows by name or alias). What the Torvex browser extension shows on every Ads Manager campaign row; an 'unmatched' FB campaign in the cost sync is exactly a missing link.

Facebook auto-rules (conditions, actions, schedule).

Bell notifications (domain alerts, offer caps, Meta account health, billing). meta.unread carries the badge count.

List offers (paginated). Rows include affiliate network, URL, payout, countries and the conversion cap: cap_enabled, cap_period (day/week/month/total, counted in the workspace timezone), cap_limit, cap_used (conversions already counted this period; null without a cap) and cap_alt_offer_id (the fallback offer once the cap is hit).

Outgoing postback attempts to traffic-source / campaign postback URLs (HTTP code, attempt number, error).

Pixel fire attempts (Facebook CAPI, TikTok, GA4, …).

Pixel catalog (id, name, platform). Pixel credentials are never returned.

Incoming postback log: what the affiliate network actually sent (success / error / duplicate), with the booked USD payout, the original amount + currency, any error, and the full request URL as called (url: domain, path, parameters).

Proxies (passwords are never returned).

Push mailings with delivery counters (targets, sent, shown, clicked, revenue).

PWA app landings.

Root files served on tracking domains.

Site lists (placement black/white lists).

Smartlinks with rotation settings.

SSP auctions with their ordered feeds.

SSP auction bid log — one row per feed response (win / lose / below_min_price / no_bid / timeout / error).

SSP feeds with targeting and economics (discreps, min prices).

The workspace-wide tag pool.

List traffic sources (id, name, provider).

Platform templates for creating a traffic source (Push.House, PropellerAds, Meta, TikTok, …): id, provider, whether it has an API integration and the default parameter mapping. Pass a template id as template_id to create_traffic_source.

Wallet transaction history.

Whitepages, incl. AI generation status.

Workspace invitations with pending / accepted state.

Current workspace members with their role.

Workspace roles with their permission lists and per-section resource access (level full/read/own/none + allow/deny entity ids).

Dry run of an auto rule against one campaign, right now: the current metric values for the rule's window, each condition's pass/fail, the placements a zone action would touch and what the action WOULD do. Changes nothing; shows whether a rule would fire before it is attached and why it did / didn't fire.

Preview a segment cost update WITHOUT changing anything: how many clicks would carry the cost, how many days they span and what the segment currently books. The segment = period + any analytics filters (campaign alias(es) comma-separated, offer, site/zone, source_id, creative, subs, geo, groups, tags, …). The dry run of a segment cost update.