{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Postback API v2","description":"Overview of the Treasure AI Postback API v2 — the next-generation Postback ingestion endpoint served from records.in.treasuredata.com with header-based authentication.","siteUrl":"https://docs.treasure.ai","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"postback-api-v2","__idx":0},"children":["Postback API v2"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Postback API v2 is the next-generation Postback ingestion endpoint for Treasure AI. It uses the same path contract as the legacy Postback API but is served from the new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["records.in.treasuredata.com"]}," host and supports only header-based authentication."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use this API for custom webhooks, environments where the JS SDK or TD Logger cannot run, or single-record imports triggered by an external application."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-started","__idx":1},"children":["Get started"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/postback-v2/quickstart"},"children":["Quickstart"]}," — Send your first request in minutes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/postback-v2/openapi"},"children":["API Reference"]}," — Full OpenAPI specification"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-differences-from-the-legacy-postback-api","__idx":2},"children":["Key differences from the legacy Postback API"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["New host"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<region>.records.in.treasuredata.com"]}," (replaces ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["in.treasuredata.com"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Header-only auth"]},": Supports ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: TD1 <key>"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-TD-Write-Key: <key>"]},". URL-parameter auth (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?td_write_key=..."]},") is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," supported."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payload limit"]},": Maximum request body is 1,048,064 bytes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":3},"children":["Related resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/postback/quickstart"},"children":["Legacy Postback API Quickstart"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/endpoints/endpoints"},"children":["Treasure AI Sites and API Endpoints"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/integration-hub/streaming/importing-table-records-using-the-data-ingestion-api"},"children":["Data Ingestion API"]}]}]}]},"headings":[{"value":"Postback API v2","id":"postback-api-v2","depth":1},{"value":"Get started","id":"get-started","depth":2},{"value":"Key differences from the legacy Postback API","id":"key-differences-from-the-legacy-postback-api","depth":2},{"value":"Related resources","id":"related-resources","depth":2}],"frontmatter":{"seo":{"title":"Postback API v2","description":"Overview of the Treasure AI Postback API v2 — the next-generation Postback ingestion endpoint served from records.in.treasuredata.com with header-based authentication."}},"lastModified":"2026-06-28T02:29:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/postback-v2","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}