---
title: "Changes to Update lead forms"
method: PATCH
path: "/ad_accounts/{ad_account_id}/lead_forms"
---

# Changes to Update lead forms

`PATCH /ad_accounts/{ad_account_id}/lead_forms`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 1 warning, 27 info
- **2024-08-14** (v5) `89c27ed39cfd` — 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a` — 1 breaking, 1 warning, 27 info
  - added the new required request property `items/id`
  - removed `#/components/schemas/LeadFormCommon, subschema #1, subschema #3` from the `items/` request property `allOf` list
  - added the new optional request property `items/completion_message`
  - added the new optional request property `items/disclosure_language`
  - added the new optional request property `items/has_accepted_terms`
  - added the new optional request property `items/name`
  - added the new optional request property `items/policy_links`
  - added the new optional request property `items/privacy_policy_link`
  - added the new optional request property `items/questions`
  - added the new optional request property `items/status`
  - 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 `404`
  - added the non-success response with the status `429`
  - added the optional property `items/items/data/ad_account_id` to the response with the `200` status
  - added the optional property `items/items/data/created_time` to the response with the `200` status
  - added the optional property `items/items/data/disclosure_language` to the response with the `200` status
  - added the optional property `items/items/data/policy_links` to the response with the `200` status
  - added the optional property `items/items/data/status` to the response with the `200` status
  - added the optional property `items/items/data/updated_time` to the response with the `200` status
  - removed `#/components/schemas/LeadFormCommon, subschema #2` from the `items/items/data` response property `allOf` list for the response status `200`
  - the response property `items` became required for the status `200`
  - the response property `items/items/exceptions/items/message` became required for the status `200`
  - added the required property `items/items/data/completion_message` to the response with the `200` status
  - added the required property `items/items/data/has_accepted_terms` to the response with the `200` status
  - added the required property `items/items/data/id` to the response with the `200` status
  - added the required property `items/items/data/name` to the response with the `200` status
  - added the required property `items/items/data/privacy_policy_link` to the response with the `200` status
  - added the required property `items/items/data/questions` to the response with the `200` status
- **2024-08-14** (v5) `89c27ed39cfd` — 1 info
  - endpoint added

---

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