Log event

​

Request

curl -X POST https://api.apostra.com/api/v2/buyer/advertisers/12345/log-event \
  -H "Authorization: Bearer $SCOPE3_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_source_id": "website_pixel",
    "events": [
      {
        "event_id": "order_12345",
        "event_type": "purchase",
        "event_time": "2026-01-15T14:30:00Z",
        "action_source": "website",
        "event_source_url": "https://shop.example.com/checkout/complete",
        "user_match": {
          "click_id": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
          "click_id_type": "sc3clid"
        },
        "custom_data": { "value": 99.99, "currency": "USD", "order_id": "order_12345" }
      }
    ]
  }'

​

Parameters

​

Response

{
  "events_received": 1,
  "events_processed": 1,
  "partial_failures": [],
  "warnings": [],
  "match_quality": 0.87
}

​

Errors

• 400 VALIDATION_ERROR — empty events, more than 10,000 events, missing custom_event_name on a custom event, an event_type the source doesn’t accept, or (when the source has declared valueCurrencies) a monetary event with a missing or unlisted currency. Also returned when:
  • a hashed_email or hashed_phone is not a 64-character lowercase hex SHA-256;
  • a uids[].value or click_id looks like a plaintext email, or a phone number written with a leading +, spaces, hyphens, or parentheses (for example uids[0].value looks like a raw email; send hashed_email instead). A bare digit string is accepted as a numeric ID;
  • two events in the call share an event_type and event_id.
  These fail the whole request: nothing is forwarded to the tracking service. Each issue in error.details.issues names the event and field.
• 404 NOT_FOUND — advertiserId does not exist, or event_source_id is not registered on the advertiser.

​

Related