---
title: "Server Events"
method: POST
path: "/api/v1/openai-ads/conversions/server-events"
tags: ["openaiAdsConversions"]
---

# Server Events

`POST /api/v1/openai-ads/conversions/server-events`

## Request

- Base URL: `https://api.brandbooster.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brandbooster.ai/api/v1/openai-ads/conversions/server-events`
- Auth: none declared

## Headers

- `authorization` string

## Request body

- ServerEventsDTO
  - `validate_only` boolean
  - `events` ServerEventDTO[], required
    - `id` string, required
    - `type` string, required
    - `timestamp_ms` integer, required
    - `action_source` 'web'
    - `source_url` string, required
    - `data` object, required
    - `oppref` string, nullable
    - `custom_event_name` string, nullable
    - `opt_out` boolean
    - `user` ServerUserDTO
      - `obref` string, nullable
      - `emails_sha256` string[]
      - `phone_numbers_sha256` string[]
      - `external_ids_sha256` string[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-14** `707bf96f76de`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/openai-ads/conversions/server-events/post.md)

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) - [OpenAPI document](https://skmtc.dev/brandbooster/apis/fastapi/revisions/8e8c18c2dc35?raw)