Skip to main content
POST
Validate or import pre-tracking campaign analytics history

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Headers

Idempotency-Key
string
required

A client-chosen key between 8 and 200 characters. Reuse the same key only when retrying the exact same request body.

Required string length: 8 - 200

Path Parameters

id
string
required

Body

application/json
rows
object[]
required
Required array length: 1 - 2000 elements
mode
enum<string>
default:validate
Available options:
validate,
import
sourceId
string
default:external-export

Stable caller label recorded with imported snapshots.

Required string length: 1 - 160
unmatchedPostPolicy
enum<string>
default:error
Available options:
error,
skip
expectedUnmatchedPostCount
integer

Required for import + skip and must exactly match the validated batch.

Required range: 0 <= x <= 500
confirmCampaignName
string

Required for import and must equal the campaign's current name.

Required string length: 1 - 240

Response

Validation plan or verified import result.

data
object
required