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
| Action | What it does |
|---|---|
| Create lead form | Create a lead generation form: a headline, a description, the questions to ask and optional consent checkboxes. |
| Delete form webhook | Stop sending a form's leads to a web address. |
| Get lead form | Get one lead generation form with its headline, questions and privacy link. |
| List ad accounts | List every Snapchat ad account you can reach, across your organizations, with its currency and time zone. |
| List form webhooks | List the web address a lead form sends its leads to. |
| List lead forms | List an ad account's lead generation forms with their questions. |
| Send leads to a webhook | Have Snapchat send every new lead from a form to a web address. |
| Send test lead | Have 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 account
ad_account_idtextRequired - The ad account. Pick one, or give its id from an earlier step.
- Form name
nametextRequired - A name for finding the form in Ads Manager. People don't see it.
- Headline
titletextRequired - The headline at the top of the form, up to 25 characters.
- Description
descriptiontextRequired - What people get for signing up, up to 180 characters.
- Ask for
questionslist - 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 questions
extra_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 link
privacy_policy_urltext - A link to your privacy policy, starting with https://. Shown on the confirmation screen.
- Consent checkboxes
consentslist - Text for up to 2 checkboxes people tick before sending, one per row, such as agreeing to be contacted.
- Checkboxes must be ticked
consents_requiredtrue/false - Whether people have to tick the checkboxes to send the form. On by default.Default:
true. - Button on the confirmation screen
end_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 link
end_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 account
ad_account_idtextRequired - The ad account. Pick one, or give its id from an earlier step.
- Lead form
lead_form_idtextRequired - The lead generation form. Pick one, or give its id from an earlier step.
- Webhook
integration_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 account
ad_account_idtextRequired - The ad account. Pick one, or give its id from an earlier step.
- Lead form
lead_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 account
ad_account_idtextRequired - The ad account. Pick one, or give its id from an earlier step.
- Lead form
lead_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 account
ad_account_idtextRequired - The ad account. Pick one, or give its id from an earlier step.
- Most to return
limitnumber - 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 account
ad_account_idtextRequired - The ad account. Pick one, or give its id from an earlier step.
- Lead form
lead_form_idtextRequired - The lead generation form. Pick one, or give its id from an earlier step.
- Web address
webhook_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 account
ad_account_idtextRequired - The ad account. Pick one, or give its id from an earlier step.
- Lead form
lead_form_idtextRequired - The lead generation form. Pick one, or give its id from an earlier step.
- Webhook
integration_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"
}