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.

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.

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_manage_instant_form: Create, duplicate, archive or reactivate a Meta Instant Form: the lead form people fill in without leaving Facebook or Instagram.

Guide

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

Get instant form (adsap_get_instant_form)