---
title: "Changes to Create lead ads subscription"
method: POST
path: "/ad_accounts/{ad_account_id}/leads/subscriptions"
---

# Changes to Create lead ads subscription

`POST /ad_accounts/{ad_account_id}/leads/subscriptions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 29 revisions.

- **2025-07-16** (v5) `43134ca41f18`: 3 breaking, 3 warning, 5 info
- **2024-08-14** (v5) `89c27ed39cfd`: 2 breaking
- **2024-04-23** (v5) `f9321315766f`: 1 info
- **2024-02-08** (v5) `7529b464d5cb`: 1 info

## Changes

- **2025-07-16** (v5) `43134ca41f18`: 3 breaking, 3 warning, 5 info
  - added `subschema #1` to the request body `allOf` list
  - added `subschema #1` to the `partner_metadata` request property `allOf` list
  - the `partner_metadata` request property type changed from `object` to no type
  - removed the request property `lead_form_id`
  - removed the request property `partner_metadata/subscriber_key`
  - removed the request property `webhook_url`
  - added the optional property `ad_account_id` to the response with the `200` status
  - added the optional property `api_version` to the response with the `200` status
  - added the optional property `lead_form_id` to the response with the `200` status
  - added the optional property `user_account_id` to the response with the `200` status
  - added the optional property `webhook_url` to the response with the `200` status
- **2024-08-14** (v5) `89c27ed39cfd`: 2 breaking
  - the response property `cryptographic_algorithm` became nullable for the status `200`
  - the response property `cryptographic_key` became nullable for the status `200`
- **2024-04-23** (v5) `f9321315766f`: 1 info
  - added the new optional request property `partner_metadata`
- **2024-02-08** (v5) `7529b464d5cb`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/ad_accounts/:ad_account_id/leads/subscriptions/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/leads/subscriptions/post)