Tealium

Tealium Collect API

The Collect API from Tealium — 6 operation(s) for collect.

GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /collect/event Send a tracking event as a pixel GET · Send single event (GET) #
Ask an LLM
“Can I send an event with a plain GET request that returns a tracking pixel?”
“Is there a 1x1 GIF image endpoint for pixel-based event tracking?”
Tell an agent
Fire pixel event {tealium_event} for account {tealium_account} profile {tealium_profile} via a GET request.
Send a GET pixel hit for event {tealium_event} on {tealium_account}/{tealium_profile} tied to visitor {tealium_visitor_id}.
POST /collect/event Send one event as a JSON POST · Send single event (POST) #
Ask an LLM
“How do I post a single event to Tealium Collect as a JSON body?”
“Can I tag a single JSON event with the deployment environment it came from?”
Tell an agent
POST event {tealium_event} as JSON to the global collect endpoint for {tealium_account} profile {tealium_profile}.
Send a JSON event {tealium_event} for {tealium_account}/{tealium_profile} in environment {tealium_environment} with data source {tealium_datasource}.
POST /collect/bulk-event Send a batch of up to 10 events · Send bulk events (up to 10) #
Ask an LLM
“Can I send several tracking events in one request instead of one at a time?”
“What is the maximum number of events allowed in a single bulk collect call?”
Tell an agent
Send these {events} in one bulk request to the global endpoint with shared fields {shared}.
Batch up to ten events {events} into one global bulk-event call using common fields {shared}.
POST /collect/regional/event Send one event to a regional collect host · Send single event to regional endpoint #
Ask an LLM
“How do I send a single event to the region-specific host returned by authentication?”
“Can I keep event data routed to my region when posting one event?”
Tell an agent
Send event {tealium_event} for {tealium_account}/{tealium_profile} to the regional collect endpoint.
Post visitor {tealium_visitor_id}'s event {tealium_event} on {tealium_account}/{tealium_profile} through my regional host.
POST /collect/regional/bulk-event Send a batch of events to a regional host · Send bulk events to regional endpoint #
Ask an LLM
“Can I batch up to 10 events to my region-specific collect endpoint?”
“Is there a regional version of the bulk event upload?”
Tell an agent
Send the batch {events} with shared fields {shared} to the regional bulk-event endpoint.
Upload these events {events} in one call to my regional host, applying {shared} to each.
POST /collect/integration/event/accounts/{account}/profiles/{profile}/datasources/{datasourceId} Send an event through a webhook data source · Send event via webhook/integration datasource #
Ask an LLM
“How do I push an event from a webhook into a specific Tealium data source?”
“Which endpoint should a connector use to send events to a dedicated integration data source?”
Tell an agent
Send event {tealium_event} to data source {datasourceId} on account {account} profile {profile} via the integration endpoint.
Forward this webhook as event {tealium_event} into integration data source {datasourceId} for {account}/{profile}.

Documentation

📖
Documentation
https://docs.tealium.com/api/v3/http-api/endpoints/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tealium/refs/heads/main/openapi/tealium-collect-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/tealium/refs/heads/main/overlays/tealium-collect-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/tealium:tealium-collect-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

tealium-collect-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Tealium HTTP Collect API
  description: Sends authenticated events from any application via HTTP requests into the Tealium Customer Data Hub. Supports single-event and bulk-event endpoints (up to 10 events per request) with regional routing. Rate limit is 100 events per second; exceeding this returns HTTP 429. Authenticates via JWT bearer token obtained by exchanging a username and API key.
  version: '3.0'
  contact:
    name: Tealium Support
    url: https://docs.tealium.com/api/v3/http-api/about/
servers:
- url: https://{host}/v3
  description: Region-specific host returned by authentication API
  variables:
    host:
      default: platform.tealiumapis.com
      description: Region-specific host from auth response (e.g., us-east-1-platform.tealiumapis.com)
security:
- BearerAuth: []
tags:
- name: Collect
paths:
  /collect/event:
    get:
      operationId: collectEventGet
      summary: Send single event (GET)
      description: Sends a single event via HTTP GET. Returns a 1x1 transparent GIF image. Useful for pixel-based tracking scenarios.
      parameters:
      - name: tealium_account
        in: query
        required: true
        schema:
          type: string
        description: Tealium account name
      - name: tealium_profile
        in: query
        required: true
        schema:
          type: string
        description: Tealium profile name
      - name: tealium_event
        in: query
        required: true
        schema:
          type: string
        description: Event type identifier
      - name: tealium_visitor_id
        in: query
        required: false
        schema:
          type: string
        description: Visitor identifier (GUID or formatted known-visitor ID)
      - name: tealium_datasource
        in: query
        required: false
        schema:
          type: string
        description: Data source key
      responses:
        '200':
          description: Event accepted; returns 1x1 transparent GIF
          content:
            image/gif:
              schema:
                type: string
                format: binary
        '400':
          description: Bad request — missing required parameters
        '401':
          description: Unauthorized — invalid or expired bearer token
        '429':
          description: Too many requests — rate limit exceeded (100 events/second)
      tags:
      - Collect
    post:
      operationId: collectEventPost
      summary: Send single event (POST)
      description: Sends a single event via HTTP POST with a JSON body. Returns an empty JSON response with content-length 0.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EventPayload'
            example:
              tealium_account: my-account
              tealium_profile: main
              tealium_event: page_view
              tealium_datasource: abc123
              page_type: '123'
              page_name: testName
      responses:
        '200':
          description: Event accepted
        '400':
          description: Bad request — missing required fields, invalid JSON keys, or empty body
        '401':
          description: Unauthorized — invalid or expired bearer token
        '429':
          description: Too many requests — rate limit exceeded
      tags:
      - Collect
  /collect/bulk-event:
    post:
      operationId: collectBulkEvent
      summary: Send bulk events (up to 10)
      description: Sends up to 10 events in a single POST request. The shared object provides common fields applied to all events; individual event objects can override or extend them.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkEventPayload'
            example:
              shared:
                tealium_account: my-account
                tealium_profile: main
                tealium_environment: prod
                tealium_datasource: abc123
                tealium_visitor_id: abc123_071222_1
              events:
              - page_name: home
                tealium_event: page_view
              - page_name: checkout
                tealium_event: page_view
      responses:
        '200':
          description: Bulk events accepted
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '429':
          description: Too many requests — rate limit exceeded
      tags:
      - Collect
  /collect/regional/event:
    post:
      operationId: collectRegionalEvent
      summary: Send single event to regional endpoint
      description: Sends a single event to a region-specific endpoint. Use the regional host returned from the authentication API.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EventPayload'
      responses:
        '200':
          description: Event accepted
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '429':
          description: Too many requests
      tags:
      - Collect
  /collect/regional/bulk-event:
    post:
      operationId: collectRegionalBulkEvent
      summary: Send bulk events to regional endpoint
      description: Sends up to 10 events to a region-specific endpoint.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkEventPayload'
      responses:
        '200':
          description: Bulk events accepted
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '429':
          description: Too many requests
      tags:
      - Collect
  /collect/integration/event/accounts/{account}/profiles/{profile}/datasources/{datasourceId}:
    post:
      operationId: collectIntegrationEvent
      summary: Send event via webhook/integration datasource
      description: Sends a single event via a dedicated datasource integration endpoint. Returns 204 No Content on success. Suitable for webhook and connector-based integrations.
      parameters:
      - name: account
        in: path
        required: true
        schema:
          type: string
        description: Tealium account name
      - name: profile
        in: path
        required: true
        schema:
          type: string
        description: Tealium profile name
      - name: datasourceId
        in: path
        required: true
        schema:
          type: string
        description: Data source key for the integration
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IntegrationEventPayload'
            example:
              tealium_event: page_view
              tealium_datasource: abc123
              page_type: '123'
              page_name: homepage
      responses:
        '204':
          description: Event accepted — no content returned
        '400':
          description: Bad request
        '401':
          description: Unauthorized
        '429':
          description: Too many requests
      tags:
      - Collect
components:
  schemas:
    IntegrationEventPayload:
      type: object
      required:
      - tealium_event
      properties:
        tealium_event:
          type: string
          description: Event type identifier
        tealium_datasource:
          type: string
          description: Data source key
      additionalProperties:
        type: string
        description: Custom event attributes
    EventPayload:
      type: object
      required:
      - tealium_account
      - tealium_profile
      - tealium_event
      properties:
        tealium_account:
          type: string
          description: Tealium account name
        tealium_profile:
          type: string
          description: Tealium profile name
        tealium_event:
          type: string
          description: Event type identifier
        tealium_visitor_id:
          type: string
          description: Visitor identifier (GUID or formatted known-visitor ID)
        tealium_datasource:
          type: string
          description: Data source key
        tealium_environment:
          type: string
          enum:
          - dev
          - qa
          - prod
          description: Deployment environment
      additionalProperties:
        type: string
        description: Custom event attributes as additional key-value pairs
    BulkEventPayload:
      type: object
      required:
      - shared
      - events
      properties:
        shared:
          type: object
          description: Common fields applied to all events in this batch
          properties:
            tealium_account:
              type: string
            tealium_profile:
              type: string
            tealium_environment:
              type: string
              enum:
              - dev
              - qa
              - prod
            tealium_datasource:
              type: string
            tealium_visitor_id:
              type: string
          additionalProperties:
            type: string
        events:
          type: array
          description: Array of event objects (max 10 per request)
          maxItems: 10
          items:
            type: object
            required:
            - tealium_event
            properties:
              tealium_event:
                type: string
            additionalProperties:
              type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT bearer token obtained from the Authentication API (/v3/auth/accounts/{account}/profiles/{profile}). Tokens are valid for 30 minutes. Do not generate a new token for every call — reuse until expiration.