Get instant form (`adsap_get_instant_form`)

Platform: Meta · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No

What it does

Reads one Meta Instant Form in full: its questions, intro, privacy policy, custom disclaimer, thank-you screen and tracking parameters, plus its status and lead count. The form comes back in the same shape adsap_manage_instant_form takes, so it doubles as the starting point for a duplicate.

When to use it

Use it to check what a form asks before you put it in a lead ad.
Use it before duplicating a form, to see which sections you want to change.
It needs the form’s form_id. To list a Page’s forms, use adsap_list_meta_assets with asset_type instant_forms.
It reads only. To create, duplicate or archive a form, use adsap_manage_instant_form.
In Adsap itself, the View button on the Instant Forms page shows the same content.

Worked example

You ask

“What does my Newsletter signup form ask for?”

The assistant calls `adsap_get_instant_form`


{
  "ad_account_id": "act_1234567890",
  "page_id": "100000000000001",
  "form_id": "200000000000001"
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "ok": true,
  "operation": "get",
  "form_id": "200000000000001",
  "page_id": "100000000000001",
  "status": "ACTIVE",
  "leads_count": 42,
  "created_time": "2026-09-19T12:00:28+0000",
  "form": {
    "name": "Newsletter signup",
    "form_type": "more_volume",
    "block_organic": false,
    "questions": [
      { "type": "FULL_NAME", "key": "full_name" },
      { "type": "EMAIL", "key": "email" },
      {
        "type": "CUSTOM",
        "label": "Which product are you interested in?",
        "key": "which_product_are_you_interested_in",
        "options": ["Signs", "Lamps"]
      }
    ],
    "privacy_policy": { "url": "https://example.com/privacy", "link_text": "" },
    "thank_you": { "title": "Thanks, you are on the list.", "button_type": "NONE" }
  },
  "warnings": []
}

How to read it

form holds the content, status says whether the form can still be used in new ads (ACTIVE) or not (ARCHIVED), and leads_count is Meta’s running total. A CUSTOM question with options is multiple choice; without them it is a short answer. Each question’s key is its internal name: the answers to that question arrive under this field name.

warnings names anything the form uses that Adsap cannot recreate, such as conditional logic built in Meta. The form still works in ads; a duplicate made through Adsap would not carry those parts over.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`ad_account_id`	string	Yes	Meta ad account (act_…) the Page is connected to.
`page_id`	string	Yes	Numeric id of the Facebook Page that owns the form.
`form_id`	string	Yes	Numeric id of the form, from adsap_list_meta_assets (asset_type instant_forms).

Example prompts

“Show me the questions on my Summer contest form.”
“Which of my forms on the brand Page has a custom disclaimer?”

Notes

Reading a form uses no task. A form that does not belong to the page_id you passed comes back as FORM_NOT_ON_PAGE.

adsap_list_ads: List ALL ads inside an ad set or a campaign, live from Meta: including ads created today that have no delivery yet (which insights-based…
adsap_manage_instant_form: Create, duplicate, archive or reactivate a Meta Instant Form: the lead form people fill in without leaving Facebook or Instagram.
adsap_search_detailed_targeting: Search Meta detailed targeting the way Ads Manager’s search box does: interests, behaviors AND demographics (job titles, employers…

Guide

Read AI Copilot usage for the workflow around this tool, and the Tool reference for every tool.

The Meta Ads MCP server page shows how to connect Meta Ads to Claude, ChatGPT or Perplexity.

Get instant form (adsap_get_instant_form)