Skip to content
adscapi

Taboola CAPI Payload Preview

The server-side request adscapi builds when you track() a purchase and Taboola is configured. Secrets and hashed values show as placeholders.

Request

POST
Endpoint
https://trc.taboola.com/{TABOOLA_ACCOUNT_ID}/log/3/bulk-s2s-action
Headers
Content-Type: application/json
Body (purchase example)
{
  "actions": [
    {
      "timestamp": 1739452800000,
      "click-id": "tblci-example-123",
      "name": "purchase",
      "revenue": 49.99,
      "currency": "USD"
    }
  ]
}

Verified against the library dispatcher (src/dispatchers/taboola.ts). See the Taboola setup guide for where to get each secret.

Required secrets

TABOOLA_ACCOUNT_ID

Taboola activates when every secret is present. One missing key and the platform no-ops — the rest still receive the event.

Event-name mapping

Canonical eventTaboola receives
page_viewpage_view
leadlead
signup_startsignup_start (custom event passthrough)
signupsignup
checkout_createdcheckout_created
purchasepurchase
reply_generatedreply_generated (custom event passthrough)
upgrade_clickedupgrade_clicked (custom event passthrough)

Good to know

  • No auth header and no token: the account id is the URL path segment and the tblci click id is the only match key.
  • timestamp is milliseconds since the Unix epoch; adscapi multiplies its epoch-seconds eventTime by 1000.
  • No PII is sent. The dispatcher no-ops without clickIds.tblci or without adPersonalization consent.
  • name is case-sensitive and must match a conversion rule configured in the Taboola (Realize) console. Success is 204 No Content.

Frequently Asked Questions

Related Tools

Discover more free tools to fix your tracking

Event Payload Playground

Pick a canonical conversion event, fill the fields, and see the exact JSON payload adscapi builds — before you write a line of code.

Try it now

PII Hash Previewer

Type a raw email or phone number and see the normalized value plus its SHA-256 hash — the exact rules adscapi applies per platform. Nothing leaves the browser.

Try it now

Platform Coverage Explorer

Search all 26 ad platforms adscapi dispatches to — support level, required secrets, and setup docs, always in sync with the library registry.

Try it now

Ready to track Taboola conversions server-side?

adscapi is free and open source. Set your platform tokens, call track() once, and every configured Conversions API receives the event — hashed the way each platform expects.

Get startednpm install adscapi