Skip to main content
POST
/
advertisers
/
{advertiserId}
/
log-event
Log conversion events
curl --request POST \
  --url https://api.interchange.io/api/v2/buyer/advertisers/{advertiserId}/log-event \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_source_id": "es_abc123",
  "events": [
    {
      "event_id": "txn_abc123",
      "event_type": "purchase",
      "event_time": "2026-03-15T14:30:00-05:00",
      "user_match": {
        "uids": [
          {
            "type": "<string>",
            "value": "<string>"
          }
        ],
        "hashed_email": "<string>",
        "hashed_phone": "<string>",
        "click_id": "<string>",
        "click_id_type": "<string>",
        "client_ip": "<string>",
        "client_user_agent": "<string>"
      },
      "custom_data": {
        "value": 123,
        "currency": "<string>",
        "order_id": "<string>",
        "content_ids": [
          "<string>"
        ],
        "content_type": "<string>",
        "num_items": 4503599627370495,
        "contents": [
          {
            "id": "<string>",
            "quantity": 123,
            "price": 123,
            "brand": "<string>"
          }
        ]
      },
      "action_source": "website",
      "event_source_url": "<string>",
      "custom_event_name": "<string>"
    }
  ]
}
'
{
  "events_received": 4503599627370495,
  "events_processed": 4503599627370495,
  "partial_failures": [
    {
      "event_id": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ],
  "warnings": [
    "<string>"
  ],
  "match_quality": 0.5
}

Documentation Index

Fetch the complete documentation index at: https://docs.interchange.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

advertiserId
string
required

Unique identifier for the advertiser

Minimum string length: 1
Example:

"12345"

Body

application/json

Request body for logging conversion or marketing events (ADCP spec)

event_source_id
string
required

Event source configured on the account via sync_event_sources

Required string length: 1 - 256
Example:

"es_abc123"

events
object[]
required

Events to log (up to 10,000 per call)

Required array length: 1 - 10000 elements
test_event_code
string

Test event code for validation without affecting production data

Maximum string length: 256

Response

Log conversion events

Response from log_event

events_received
integer
required

Number of events received

Required range: 0 <= x <= 9007199254740991
events_processed
integer
required

Number of events successfully queued

Required range: 0 <= x <= 9007199254740991
partial_failures
object[]

Events that failed validation

warnings
string[]

Non-fatal issues (low match quality, missing fields)

match_quality
number

Overall match quality score

Required range: 0 <= x <= 1