---
title: "Create Event Setting"
method: POST
path: "/api/v1/openai-ads/conversions/event-settings"
tags: ["openaiAds"]
---

# Create Event Setting

`POST /api/v1/openai-ads/conversions/event-settings`

## 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/event-settings`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Request body

- CreateEventSettingRequestDTO
  - `account_id` string, required
  - `source_id` string, required
  - `event_type` 'order_created' | 'checkout_started' | 'items_added' | 'contents_viewed' | 'page_viewed' | 'lead_created' | 'registration_completed' | 'appointment_scheduled' | 'subscription_created' | 'trial_started' | 'custom', required
  - `custom_event_name` string, nullable
  - `name` string, nullable

## Response `200`

Successful Response

- OpenAIAdsResponseDTOEventSettingCreateResultDTO
  - `code` integer
  - `message` string
  - `data` EventSettingCreateResultDTO, required
    - `event_setting` DtoResponseOpenaiAdsResponseDTOEventSettingDTO, required
      - `id` string, required
      - `name` string, nullable
      - `event_type` string, nullable
      - `custom_event_name` string, nullable
      - `source_ids` string[]
      - `attribution_window_days` integer, nullable
      - `archived` boolean
      - `campaign_count` integer
    - `created` boolean, required
    - `upstream` UpstreamCallDTO[]
      - `method` string, required
      - `path` string, required
      - `idempotency_key` string, nullable
      - `result` string, nullable
      - `error` string, nullable
  - `error_code` string, nullable

## Other responses

- `422`: Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-10-22** `23eb62d854e6`: 3 breaking, 1 warning, 25 info
  - request property `event_type` was restricted to a list of enum values
  - the response property `data/event_setting/archived` became optional for the status `200`
  - the response property `data/event_setting/campaign_count` became optional for the status `200`
  - the `custom_event_name/anyOf[subschema #1]/` request property's maxLength was set to `255`
  - …25 more
- **2026-10-14** `707bf96f76de`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/openai-ads/conversions/event-settings/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)