---
title: "List Social Account Lead Forms"
method: GET
path: "/social_accounts/{id}/lead_forms"
tags: ["Social Accounts"]
---

# List Social Account Lead Forms

`GET /social_accounts/{id}/lead_forms`

Lists the active lead (instant) forms that already exist on a connected Facebook page, so an ad can reuse one as its `lead_gen_form_id` instead of authoring a new form. Every active form comes back in a single response — the list is not paginated.

## Query parameters

- `account_id` string, required

## Response `200`

lead forms listed

- object
  - `data` SocialAccountLeadForm[], required
    - `completion` AdLeadFormCompletion, required
      - `button_text` string, nullable, required — Text of the follow-up button.
      - `description` string, nullable, required — Body text under the headline.
      - `headline` string, nullable, required — Headline of the completion screen.
      - `url` string, nullable, required — Website the follow-up button opens. `null` when the screen has no button.
    - `created_at` string, nullable, required — When the form was created, as an ISO 8601 timestamp.
    - `disclaimer` AdLeadFormDisclaimer, required
      - `body` string, nullable, required — Disclaimer text.
      - `checkboxes` AdLeadFormDisclaimerCheckbox[], required
        - `checked_by_default` boolean, nullable, required — Whether the checkbox starts ticked.
        - `key` string, nullable, required — Stable identifier consent responses are stored under.
        - `required` boolean, nullable, required — Whether the checkbox must be ticked to submit the form.
        - `text` string, required — Consent text next to the checkbox.
      - `title` string, nullable, required — Disclaimer title.
    - `form_type` 'more_volume' | 'higher_intent', required — `more_volume` is quickest to submit; `higher_intent` adds a confirmation step before submission.
    - `id` string, required — The ad platform's identifier for the form. Use it as lead_gen_form_id on an ad to reuse the form.
    - `intro` AdLeadFormIntro, required
      - `description` string, nullable, required — Body text under the headline.
      - `headline` string, nullable, required — Headline of the intro screen.
    - `locale` string, nullable, required — Language the form is shown in, such as en_US.
    - `name` string, nullable, required — Advertiser-facing form name.
    - `privacy_policy_link_text` string, nullable, required — Custom link text for the privacy policy. `null` when the default is used.
    - `privacy_policy_url` string, nullable, required — Privacy policy URL configured on the form.
    - `question_labels` string[], required
    - `questions` AdLeadFormQuestion[], required
      - `format` string — Answer format for `custom` questions: `short_answer`, `multiple_choice`, or `appointment`. Absent otherwise.
      - `label` string — Question text for `custom` questions. Absent for standard prefill questions.
      - `options` AdLeadFormQuestionOption[]
        - `key` string, nullable — Stable identifier the choice's answers are stored under. Absent for simple choices.
        - `logic` AdLeadFormOptionLogic
          - `action` 'go_to_question' | 'submit_form' | 'close_form', required — What happens when the choice is selected.
          - `target_end_page_index` number — Zero-based index of the ending screen to jump to.
          - `target_question_index` number — Zero-based index of the question to jump to, for `go_to_question`.
        - `value` string, required — Choice text shown to the person.
      - `type` string, required — Question type: a standard prefill type such as `email`, `phone`, or `full_name`, or `custom` for your own question.

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `404` — Resource not found

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)