Retrieve a lead form by id. Pass isDraft=true to read an unpublished local draft instead, in which case leadFormId accepts either the bare id or the draft_-prefixed form the listing endpoint reports. The two branches return different shapes, and neither matches the shape the listing endpoint returns for the same form: the published branch carries the full Meta definition (context card, thank-you page, legal content) but no status, createdTime, or pageId, while the draft branch returns the stored document verbatim under _id.
Authorizations
Authorizationstringheaderrequired
Bearer authentication header of the form Bearer <token>, where <token> is your access token.
Fetch the unpublished draft of this lead form instead of the published form
Example:true
Response
application/json
The published form from Meta, or the stored draft when isDraft is set
oneOf
FacebookLeadFormDetailDTO
FacebookDraftLeadFormDetailDTO
idstringrequired
Facebook lead form id
Example:1731762131493784
namestringrequired
Form name
Example:Automation Lead Form 2026-07-16 00:22:40
localestringrequired
Form locale, lower-cased by Meta
Example:en_US
questionsobject[]required
Questions on the form
questions[].idstringrequired
Facebook question id
Example:1751700749315902
questions[].keystringrequired
Field key the answer is delivered under. Prefilled question types use a fixed key (full_name, email, phone); CUSTOM questions get a key derived from the label.
Example:full_name
questions[].labelstringrequired
Question text shown to the user
Example:What is your name?
questions[].typestringrequired
Question type. CUSTOM is a free-text or multiple-choice question authored on the form; every other value is a Facebook prefilled field.
Example:CUSTOM
questions[].optionsobject[]
Choices, present only on multiple-choice questions
questions[].options[].keystringrequired
Option key
Example:Option 1
questions[].options[].valuestringrequired
Option display value
Example:Option 1
contextCardobject
Intro card shown before the questions. The draft representation calls this greetingCard.
contextCard.idstringrequired
Meta id for the card
Example:1320904143101881
contextCard.titlestringrequired
Card headline
Example:Test Lead Form
contextCard.contentstring[]required
Body lines, rendered as a paragraph or bullets depending on style
Example:["Automation test lead form"]
contextCard.stylestringrequired
Layout of the body
Available optionsLIST_STYLEPARAGRAPH_STYLE
Example:PARAGRAPH_STYLE
questionPageCustomHeadlinestring
Headline above the questions. The draft representation calls this questionPageHeadline.
Example:Test Lead Form - Headline
isOptimizedForQualityboolean
Whether the form uses the higher-intent flow, which adds a review step. Set when the form was created with type: HIGHER_INTENT.
Example:false
privacyPolicyUrlstring
Privacy policy URL, repeated from legalContent.privacyPolicy.url
Example:https://example.com/privacy
thankYouPageobject
Confirmation screen
thankYouPage.idstringrequired
Meta id for the page
Example:1778746963315596
thankYouPage.titlestringrequired
Headline
Example:Thank You
thankYouPage.bodystringrequired
Body copy
Example:We will contact you shortly.
thankYouPage.buttonTextstringrequired
Call-to-action button label
Example:View website
thankYouPage.buttonTypestringrequired
Button action
Available optionsVIEW_WEBSITECALL_BUSINESSDOWNLOAD
Example:VIEW_WEBSITE
thankYouPage.websiteUrlstring
Destination URL. The draft representation calls this same value buttonLink.
Example:https://example.com/
thankYouPage.enableMessengerboolean
Whether a Messenger hand-off is offered after submit
Example:false
followUpActionUrlstring
URL the follow-up action opens
Example:https://example.com/
followUpActionTextstring
Label for the follow-up action. Omitted by Meta when unset.
Example:Visit us
legalContentobject
Privacy policy and disclaimer
legalContent.idstringrequired
Meta id for the legal block
Example:1975017193204256
legalContent.privacyPolicyobject
Privacy policy link
legalContent.privacyPolicy.urlstringrequired
Privacy policy URL
Example:https://example.com/privacy
legalContent.privacyPolicy.linkTextstringrequired
Link text shown to the user
Example:We respect your privacy
legalContent.customDisclaimerobject
Custom disclaimer block
legalContent.customDisclaimer.titlestringrequired
Disclaimer heading
Example:Terms & Conditions
legalContent.customDisclaimer.bodyobjectrequired
Disclaimer copy, wrapped in an object by Meta rather than returned as a plain string