---
title: "Changes to Send conversions"
method: POST
path: "/ad_accounts/{ad_account_id}/events"
---

# Changes to Send conversions

`POST /ad_accounts/{ad_account_id}/events`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 15 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a`: 34 breaking, 8 info
- **2025-12-11** (v5) `537bde5a50b1`: 2 breaking, 3 info
- **2025-12-11** (v5) `79f62f71f05b`: 2 breaking, 4 info
- **2025-12-10** (v5) `6768e3ca1ffa`: 2 breaking, 3 info
- **2025-10-16** (v5) `14c297539b64`: 2 breaking, 3 info
- **2025-08-14** (v5) `7d64d863909a`: 2 breaking, 3 info
- **2025-08-12** (v5) `8fb7ab040159`: 2 breaking, 3 info
- **2025-07-16** (v5) `43134ca41f18`: 2 breaking, 5 info
- **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 12 warning, 3 info
- **2024-08-14** (v5) `89c27ed39cfd`: 1 breaking, 1 info
- **2024-02-08** (v5) `7529b464d5cb`: 5 info
- **2023-07-14** (v5) `52586a274771`: 4 info
- **2023-05-12** (v5) `689b4b267639`: 14 breaking, 5 info
- **2023-02-14** (v5) `be19b77aa78a`: 1 breaking, 2 info
- **2022-11-14** (v5) `e041d7b0cef0`: 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a`: 34 breaking, 8 info
  - added `#/components/schemas/ConversionEventsUserDataProperties` to the `data/items/user_data` request property `allOf` list
  - added `#/components/schemas/FormFactor` to the `data/items/device_info/form_factor` request property `allOf` list
  - added `#/components/schemas/NetworkType` to the `data/items/device_info/network_type` request property `allOf` list
  - added `#/components/schemas/OsFamily` to the `data/items/device_info/os_family` request property `allOf` list
  - removed `#/components/schemas/ConversionEventsUserDataProperties, #/components/schemas/ConversionEventsUserDataProperties, #/components/schemas/ConversionEventsUserDataProperties` from the `data/items/user_data` request property `anyOf` list
  - removed the enum value `android` of the request property `data/items/device_info/os_family`
  - removed the enum value `bsd` of the request property `data/items/device_info/os_family`
  - removed the enum value `cellphone` of the request property `data/items/device_info/form_factor`
  - removed the enum value `cellular_2g` of the request property `data/items/device_info/network_type`
  - removed the enum value `cellular_3g` of the request property `data/items/device_info/network_type`
  - removed the enum value `cellular_4g` of the request property `data/items/device_info/network_type`
  - removed the enum value `cellular_5g` of the request property `data/items/device_info/network_type`
  - removed the enum value `cellular_6g` of the request property `data/items/device_info/network_type`
  - removed the enum value `console` of the request property `data/items/device_info/form_factor`
  - removed the enum value `desktop` of the request property `data/items/device_info/form_factor`
  - removed the enum value `ethernet` of the request property `data/items/device_info/network_type`
  - removed the enum value `ios` of the request property `data/items/device_info/os_family`
  - removed the enum value `laptop` of the request property `data/items/device_info/form_factor`
  - removed the enum value `linux` of the request property `data/items/device_info/os_family`
  - removed the enum value `macos` of the request property `data/items/device_info/os_family`
  - removed the enum value `other` of the request property `data/items/device_info/form_factor`
  - removed the enum value `other` of the request property `data/items/device_info/os_family`
  - removed the enum value `smartwatch` of the request property `data/items/device_info/form_factor`
  - removed the enum value `tablet` of the request property `data/items/device_info/form_factor`
  - removed the enum value `tv` of the request property `data/items/device_info/form_factor`
  - removed the enum value `unknown` of the request property `data/items/device_info/network_type`
  - removed the enum value `vr` of the request property `data/items/device_info/form_factor`
  - removed the enum value `wifi` of the request property `data/items/device_info/network_type`
  - removed the enum value `windows` of the request property `data/items/device_info/os_family`
  - the `data/items/device_info/form_factor` request property type changed from `string` to no type
  - the `data/items/device_info/network_type` request property type changed from `string` to no type
  - the `data/items/device_info/os_family` request property type changed from `string` to no type
  - the `data/items/user_data` request property type changed from `object` to no type
  - the `events/items/status` response's property type changed from `string` to no type for status `200`
  - added the new optional request property `data/items/custom_data/contents/items/item_brand_id`
  - added the non-success response with the status `404`
  - added `#/components/schemas/EventProcessingStatus` to the `events/items/status` response property `allOf` list for the response status `200`
  - removed the `failed` enum value from the `events/items/status` response property for the response status `200`
  - removed the `processed` enum value from the `events/items/status` response property for the response status `200`
  - the response required property `events` became read-only for the status `200`
  - …2 more
- **2025-12-11** (v5) `537bde5a50b1`: 2 breaking, 3 info
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent` became optional
- **2025-12-11** (v5) `79f62f71f05b`: 2 breaking, 4 info
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em` became required
  - added the new optional request property `data/items/custom_data/predicted_ltv`
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent` became optional
- **2025-12-10** (v5) `6768e3ca1ffa`: 2 breaking, 3 info
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent` became optional
- **2025-10-16** (v5) `14c297539b64`: 2 breaking, 3 info
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent` became optional
- **2025-08-14** (v5) `7d64d863909a`: 2 breaking, 3 info
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent` became optional
- **2025-08-12** (v5) `8fb7ab040159`: 2 breaking, 3 info
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent` became optional
- **2025-07-16** (v5) `43134ca41f18`: 2 breaking, 5 info
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/em` became required
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/em` became required
  - added the new optional request property `data/items/app_info`
  - added the new optional request property `data/items/device_info`
  - the request property `data/items/user_data/anyOf[subschema #2: HashedMaidsConversionEventsUserDataPropertyRequired -> subschema #2: EMConversionEventsUserDataPropertyRequired]/hashed_maids` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_ip_address` became optional
  - the request property `data/items/user_data/anyOf[subschema #3: ClientIPAddressConversionEventsUserDataPropertyRequired -> subschema #3: EMConversionEventsUserDataPropertyRequired]/client_user_agent` became optional
- **2025-04-04** (v5) `10f9eba4ad97`: 1 breaking, 12 warning, 3 info
  - removed `subschema #1, subschema #2, subschema #3` from the `data/items/user_data` request property `anyOf` list
  - removed the request property `data/items/user_data/click_id`
  - removed the request property `data/items/user_data/country`
  - removed the request property `data/items/user_data/ct`
  - removed the request property `data/items/user_data/db`
  - removed the request property `data/items/user_data/external_id`
  - removed the request property `data/items/user_data/fn`
  - removed the request property `data/items/user_data/ge`
  - removed the request property `data/items/user_data/ln`
  - removed the request property `data/items/user_data/partner_id`
  - removed the request property `data/items/user_data/ph`
  - removed the request property `data/items/user_data/st`
  - removed the request property `data/items/user_data/zp`
  - added the new optional request property `data/items/custom_data/external_measurement_id`
  - added the new optional request property `data/items/custom_data/external_measurement_vendor_id`
  - added `#/components/schemas/ConversionEventsUserDataProperties, #/components/schemas/ConversionEventsUserDataProperties, #/components/schemas/ConversionEventsUserDataProperties` to the `data/items/user_data` request property `anyOf` list
- **2024-08-14** (v5) `89c27ed39cfd`: 1 breaking, 1 info
  - removed `subschema #1, subschema #2, subschema #3` from the `data/items/user_data` request property `anyOf` list
  - added `subschema #1, subschema #2, subschema #3` to the `data/items/user_data` request property `anyOf` list
- **2024-02-08** (v5) `7529b464d5cb`: 5 info
  - added the new optional request property `data/items/custom_data/contents/items/item_brand`
  - added the new optional request property `data/items/custom_data/contents/items/item_category`
  - added the new optional request property `data/items/custom_data/contents/items/item_name`
  - added the new optional request property `data/items/user_data/partner_id`
  - added the non-success response with the status `422`
- **2023-07-14** (v5) `52586a274771`: 4 info
  - added the new optional request property `data/items/custom_data/content_brand`
  - added the new optional request property `data/items/custom_data/content_category`
  - added the new optional request property `data/items/custom_data/content_name`
  - added the new optional request property `data/items/custom_data/contents/items/id`
- **2023-05-12** (v5) `689b4b267639`: 14 breaking, 5 info
  - removed `subschema #1, subschema #2, subschema #3` from the `data/items/user_data` request property `anyOf` list
  - removed the enum value `add_to_cart` of the request property `data/items/event_name`
  - removed the enum value `app_android` of the request property `data/items/action_source`
  - removed the enum value `app_ios` of the request property `data/items/action_source`
  - removed the enum value `checkout` of the request property `data/items/event_name`
  - removed the enum value `custom` of the request property `data/items/event_name`
  - removed the enum value `lead` of the request property `data/items/event_name`
  - removed the enum value `offline` of the request property `data/items/action_source`
  - removed the enum value `page_visit` of the request property `data/items/event_name`
  - removed the enum value `search` of the request property `data/items/event_name`
  - removed the enum value `signup` of the request property `data/items/event_name`
  - removed the enum value `view_category` of the request property `data/items/event_name`
  - removed the enum value `watch_video` of the request property `data/items/event_name`
  - removed the enum value `web` of the request property `data/items/action_source`
  - the endpoint scheme security `pinterest_oauth2` was added to the API
  - added `subschema #1, subschema #2, subschema #3` to the `data/items/user_data` request property `anyOf` list
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`
- **2023-02-14** (v5) `be19b77aa78a`: 1 breaking, 2 info
  - removed `subschema #1, subschema #2, subschema #3` from the `data/items/user_data` request property `anyOf` list
  - added the new optional request property `data/items/user_data/click_id`
  - added `subschema #1, subschema #2, subschema #3` to the `data/items/user_data` request property `anyOf` list
- **2022-11-14** (v5) `e041d7b0cef0`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/events/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/ad_accounts/:ad_account_id/events/post)
