---
title: "Changes to Create Event Setting"
method: POST
path: "/api/v1/openai-ads/conversions/event-settings"
---

# Changes to Create Event Setting

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

> Every recorded change to this operation, newest first.
> 35 revisions in range; 1 not diffed.

## Timeline

Changed in 2 of 35 revisions.

- **2026-10-22** `23eb62d854e6`: 3 breaking, 1 warning, 25 info
- **2026-10-14** `707bf96f76de`: 1 info

## Changes

- **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`
  - api operation id `create_event_api_v1_openai_ads_conversions_event_settings_post` removed and replaced with `create_event_setting_api_v1_openai_ads_conversions_event_settings_post`
  - api tag `openaiAds` added
  - api tag `openaiAdsOnboarding` removed
  - added the new `appointment_scheduled` enum value to the request property `event_type`
  - added the new `checkout_started` enum value to the request property `event_type`
  - added the new `contents_viewed` enum value to the request property `event_type`
  - added the new `custom` enum value to the request property `event_type`
  - added the new `items_added` enum value to the request property `event_type`
  - added the new `lead_created` enum value to the request property `event_type`
  - added the new `order_created` enum value to the request property `event_type`
  - added the new `page_viewed` enum value to the request property `event_type`
  - added the new `registration_completed` enum value to the request property `event_type`
  - added the new `subscription_created` enum value to the request property `event_type`
  - added the new `trial_started` enum value to the request property `event_type`
  - the `name/anyOf[subschema #1]/` request property's minLength was decreased from `3` to `0`
  - removed the pattern `^[A-Za-z0-9](?:[A-Za-z0-9_-]{0,62}[A-Za-z0-9])?$` from the request property `custom_event_name/anyOf[subschema #1]/`
  - added the optional property `data/upstream/items/error` to the response with the `200` status
  - added the optional property `data/upstream/items/idempotency_key` to the response with the `200` status
  - added the optional property `data/upstream/items/result` to the response with the `200` status
  - the `archived` response's property default value `false` was added for the status `200`
  - the `campaign_count` response's property default value `0` was added for the status `200`
  - the `source_ids` response's property default value `` was added for the status `200`
  - the `upstream` response's property default value `` was added for the status `200`
  - added the required property `data/upstream/items/method` to the response with the `200` status
  - added the required property `data/upstream/items/path` to the response with the `200` status
- **2026-10-14** `707bf96f76de`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/brandbooster/apis/fastapi/docs/api/v1/openai-ads/conversions/event-settings/post.md) - [API](https://skmtc.dev/brandbooster/apis/fastapi.md) - [Page](https://skmtc.dev/brandbooster/apis/fastapi/changes/api/v1/openai-ads/conversions/event-settings/post)