Sign in

v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
lead_forms

Create lead forms

This feature is currently in beta and not available to all apps, if you're interested in joining the beta, please reach out to your Pinterest account manager.

Create lead forms. Lead forms are used in lead ads and allow you to control what text appears on the lead form's description, questions and confirmation sections.

For more, see Lead ads.

post/ad_accounts/{ad_account_id}/lead_forms

Path parameters

ad_account_idstring required

Unique identifier of an ad account.

Request body

completion_messagestring nullable required

A message for people who complete the form to let them know what happens next.

disclosure_languagestring nullable

Additional disclosure language to be included in the lead form.

has_accepted_termsboolean required

Whether the advertiser has accepted Pinterest's terms of service for creating a lead ad.

By sending us TRUE for this parameter, you agree that (i) you will use any personal information received in compliance with the privacy policy you share with Pinterest, and (ii) you will comply with Pinterest's Lead Ad Terms. As a reminder, all advertising on Pinterest is subject to the Pinterest Advertising Services Agreement or an equivalent agreement as set forth on an IO

namestring nullable required

Internal name of the lead form.

privacy_policy_linkstring nullable required

A link to the advertiser's privacy policy. This will be included in the lead form's disclosure language.

status'DRAFT' | 'ACTIVE'

Status of the lead form

Example request

[
  {
    "completion_message": "Thank you for submitting. We will contact you soon.",
    "disclosure_language": "By entering your personal information, you agree that your data will be collected and used.",
    "name": "Lead Form 3/14/2023",
    "policy_links": [
      {
        "label": "Copyright",
        "link": "https://policy.pinterest.com/en/copyright"
      }
    ],
    "privacy_policy_link": "https://www.advertisername.com/privacy-policy",
    "questions": [
      {
        "question_type": "CUSTOM",
        "custom_question_field_type": "CHECKBOX",
        "custom_question_label": "What is your favorite animal?",
        "custom_question_options": [
          "Dog",
          "Cat",
          "Bird",
          "Turtle"
        ]
      }
    ],
    "status": "DRAFT"
  }
]

Response

The request has succeeded.

Example response

{
  "items": [
    {
      "data": {
        "completion_message": "Thank you for submitting. We will contact you soon.",
        "disclosure_language": "By entering your personal information, you agree that your data will be collected and used.",
        "name": "Lead Form 3/14/2023",
        "policy_links": [
          {
            "label": "Copyright",
            "link": "https://policy.pinterest.com/en/copyright"
          }
        ],
        "privacy_policy_link": "https://www.advertisername.com/privacy-policy",
        "questions": [
          {
            "question_type": "CUSTOM",
            "custom_question_field_type": "CHECKBOX",
            "custom_question_label": "What is your favorite animal?",
            "custom_question_options": [
              "Dog",
              "Cat",
              "Bird",
              "Turtle"
            ]
          }
        ],
        "status": "DRAFT"
      },
      "exceptions": [
        {
          "code": 2,
          "message": "Advertiser not found."
        }
      ]
    }
  ]
}