Snapchat Lead Generation

App · 8 actions

Capture Snapchat leads: run a workflow for every new lead from a lead generation ad, create lead forms, and send a form's leads to a web address.

Actions

ActionWhat it does
Create lead formCreate a lead generation form: a headline, a description, the questions to ask and optional consent checkboxes.
Delete form webhookStop sending a form's leads to a web address.
Get lead formGet one lead generation form with its headline, questions and privacy link.
List ad accountsList every Snapchat ad account you can reach, across your organizations, with its currency and time zone.
List form webhooksList the web address a lead form sends its leads to.
List lead formsList an ad account's lead generation forms with their questions.
Send leads to a webhookHave Snapchat send every new lead from a form to a web address.
Send test leadHave Snapchat send a made-up lead to a form's webhook, to check it arrives.

Create lead form

Create a lead generation form: a headline, a description, the questions to ask and optional consent checkboxes. Attach it to an ad in Ads Manager.

Inputs

Ad accountad_account_idtextRequired
The ad account. Pick one, or give its id from an earlier step.
Form namenametextRequired
A name for finding the form in Ads Manager. People don't see it.
HeadlinetitletextRequired
The headline at the top of the form, up to 25 characters.
DescriptiondescriptiontextRequired
What people get for signing up, up to 180 characters.
Ask forquestionslist
What else to ask. First and last name are always asked. Pick the email address, the phone number, or both. You can't pick both the street address and the postal code.One or more of: EMAIL (Email address), PHONE_NUMBER (Phone number), ADDRESS (Street address), POSTAL_CODE (Postal code), BIRTHDAY_DATE (Birthday), JOB_TITLE (Job title), COMPANY_NAME (Company name). Default: ["EMAIL", "PHONE_NUMBER"].
Extra questionsextra_questionslist
Your own questions with a typed answer, one per row, up to 8. Answers come back as custom_field_1, custom_field_2 and so on.
Privacy policy linkprivacy_policy_urltext
A link to your privacy policy, starting with https://. Shown on the confirmation screen.
Consent checkboxesconsentslist
Text for up to 2 checkboxes people tick before sending, one per row, such as agreeing to be contacted.
Checkboxes must be tickedconsents_requiredtrue/false
Whether people have to tick the checkboxes to send the form. On by default.Default: true.
Button on the confirmation screenend_page_actiontext
The button shown after sending. Used when you give a link below.One of: VIEW_WEBSITE (View website (default)), LEARN_MORE (Learn more), BOOK_NOW (Book now), APPLY_NOW (Apply now). Default: VIEW_WEBSITE.
Confirmation screen linkend_page_urltext
Where the button goes, starting with https://. Leave empty for no button.

Outputs

lead_formobject
A lead generation form
Example output
{
  "lead_form": {
    "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
    "banner_media_id": "b3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "created_at": "2026-03-01T10:00:00.000Z",
    "default_end_page": {
      "description": "We will be in touch.",
      "end_page_properties": [
        {
          "call_to_action": "VIEW_WEBSITE",
          "url": "https://www.example.com/thanks"
        }
      ],
      "headline": "Thanks!"
    },
    "description": "Tell us how to reach you and we will be in touch.",
    "form_fields": [
      {
        "is_required": true,
        "type": "FIRST_NAME"
      },
      {
        "is_required": true,
        "type": "LAST_NAME"
      },
      {
        "is_required": true,
        "type": "EMAIL"
      }
    ],
    "id": "9e91fbc4-7cc3-4cd0-ad11-c40c94859091",
    "legal_disclosures": {
      "consent_form_fields": [],
      "description": "Please confirm",
      "title": "Consent"
    },
    "name": "Spring signup",
    "privacy_policy_url": "https://www.example.com/privacy",
    "strategy_type": "STANDARD",
    "title": "Get a free quote",
    "updated_at": "2026-03-01T10:00:00.000Z"
  }
}

Delete form webhook

Stop sending a form's leads to a web address. Leads already sent stay where they went.

Inputs

Ad accountad_account_idtextRequired
The ad account. Pick one, or give its id from an earlier step.
Lead formlead_form_idtextRequired
The lead generation form. Pick one, or give its id from an earlier step.
Webhookintegration_idtextRequired
The webhook the form sends its leads to. Pick it, or give its id from an earlier step.

Outputs

deletedtrue/false
Whether it was deleted
form_idtext
The lead form
integration_idtext
Webhook id
Example output
{
  "deleted": true,
  "form_id": "9e91fbc4-7cc3-4cd0-ad11-c40c94859091",
  "integration_id": "26ed0a8c-27fd-4d28-aec7-9d21bcd0fae1"
}

Get lead form

Get one lead generation form with its headline, questions and privacy link.

Inputs

Ad accountad_account_idtextRequired
The ad account. Pick one, or give its id from an earlier step.
Lead formlead_form_idtextRequired
The lead generation form. Pick one, or give its id from an earlier step.

Outputs

lead_formobject
A lead generation form
Example output
{
  "lead_form": {
    "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
    "banner_media_id": "b3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
    "created_at": "2026-03-01T10:00:00.000Z",
    "default_end_page": {
      "description": "We will be in touch.",
      "end_page_properties": [
        {
          "call_to_action": "VIEW_WEBSITE",
          "url": "https://www.example.com/thanks"
        }
      ],
      "headline": "Thanks!"
    },
    "description": "Tell us how to reach you and we will be in touch.",
    "form_fields": [
      {
        "is_required": true,
        "type": "FIRST_NAME"
      },
      {
        "is_required": true,
        "type": "LAST_NAME"
      },
      {
        "is_required": true,
        "type": "EMAIL"
      }
    ],
    "id": "9e91fbc4-7cc3-4cd0-ad11-c40c94859091",
    "legal_disclosures": {
      "consent_form_fields": [],
      "description": "Please confirm",
      "title": "Consent"
    },
    "name": "Spring signup",
    "privacy_policy_url": "https://www.example.com/privacy",
    "strategy_type": "STANDARD",
    "title": "Get a free quote",
    "updated_at": "2026-03-01T10:00:00.000Z"
  }
}

List ad accounts

List every Snapchat ad account you can reach, across your organizations, with its currency and time zone.

Inputs

None.

Outputs

ad_accountslist
The ad accounts
countnumber
How many
Example output
{
  "ad_accounts": [
    {
      "currency": "USD",
      "id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
      "name": "Hooli Test Ad Account",
      "organization_id": "40d6719b-da09-410b-9185-0cc9c0dfed1d",
      "organization_name": "Hooli Inc",
      "status": "ACTIVE",
      "timezone": "America/Los_Angeles",
      "type": "PARTNER"
    }
  ],
  "count": 1
}

List form webhooks

List the web address a lead form sends its leads to.

Inputs

Ad accountad_account_idtextRequired
The ad account. Pick one, or give its id from an earlier step.
Lead formlead_form_idtextRequired
The lead generation form. Pick one, or give its id from an earlier step.

Outputs

countnumber
How many
integrationslist
The webhooks
Example output
{
  "count": 1,
  "integrations": [
    {
      "form_id": "9e91fbc4-7cc3-4cd0-ad11-c40c94859091",
      "integration_id": "26ed0a8c-27fd-4d28-aec7-9d21bcd0fae1",
      "webhook_url": "https://hooks.example.com/snapchat"
    }
  ]
}

List lead forms

List an ad account's lead generation forms with their questions.

Inputs

Ad accountad_account_idtextRequired
The ad account. Pick one, or give its id from an earlier step.
Most to returnlimitnumber
How many to return at most. Defaults to 100.From 1 to 1000.

Outputs

countnumber
How many were returned
has_moretrue/false
Whether more forms exist than were returned
lead_formslist
The lead forms
Example output
{
  "count": 1,
  "has_more": false,
  "lead_forms": [
    {
      "ad_account_id": "8adc3db7-8148-4fbf-999c-8d2266369d74",
      "banner_media_id": "b3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "created_at": "2026-03-01T10:00:00.000Z",
      "default_end_page": {
        "description": "We will be in touch.",
        "end_page_properties": [
          {
            "call_to_action": "VIEW_WEBSITE",
            "url": "https://www.example.com/thanks"
          }
        ],
        "headline": "Thanks!"
      },
      "description": "Tell us how to reach you and we will be in touch.",
      "form_fields": [
        {
          "is_required": true,
          "type": "FIRST_NAME"
        },
        {
          "is_required": true,
          "type": "LAST_NAME"
        },
        {
          "is_required": true,
          "type": "EMAIL"
        }
      ],
      "id": "9e91fbc4-7cc3-4cd0-ad11-c40c94859091",
      "legal_disclosures": {
        "consent_form_fields": [],
        "description": "Please confirm",
        "title": "Consent"
      },
      "name": "Spring signup",
      "privacy_policy_url": "https://www.example.com/privacy",
      "strategy_type": "STANDARD",
      "title": "Get a free quote",
      "updated_at": "2026-03-01T10:00:00.000Z"
    }
  ]
}

Send leads to a webhook

Have Snapchat send every new lead from a form to a web address. A form can send to one address. Needs the Organization Admin role.

Inputs

Ad accountad_account_idtextRequired
The ad account. Pick one, or give its id from an earlier step.
Lead formlead_form_idtextRequired
The lead generation form. Pick one, or give its id from an earlier step.
Web addresswebhook_urltextRequired
Where each lead is sent, starting with https://.

Outputs

form_idtext
The lead form
hmac_secrettext
The key Snapchat signs each delivery with
integration_idtext
Webhook id
webhook_urltext
Where leads are sent
Example output
{
  "form_id": "9e91fbc4-7cc3-4cd0-ad11-c40c94859091",
  "hmac_secret": "47941324-5cae-4344-ac10-6f7a9aa93c80",
  "integration_id": "26ed0a8c-27fd-4d28-aec7-9d21bcd0fae1",
  "webhook_url": "https://hooks.example.com/snapchat"
}

Send test lead

Have Snapchat send a made-up lead to a form's webhook, to check it arrives. A workflow that starts on new leads from this form runs for it too.

Inputs

Ad accountad_account_idtextRequired
The ad account. Pick one, or give its id from an earlier step.
Lead formlead_form_idtextRequired
The lead generation form. Pick one, or give its id from an earlier step.
Webhookintegration_idtextRequired
The webhook the form sends its leads to. Pick it, or give its id from an earlier step.

Outputs

integration_idtext
Webhook id
senttrue/false
Whether Snapchat sent it
webhook_urltext
Where it was sent
Example output
{
  "integration_id": "26ed0a8c-27fd-4d28-aec7-9d21bcd0fae1",
  "sent": true,
  "webhook_url": "https://hooks.example.com/snapchat"
}

On this page