# Snapchat Lead Generation

> 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.

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/snapchat-lead-generation

## Actions

### 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_id`, text, required): The ad account. Pick one, or give its id from an earlier step.
- Form name (`name`, text, required): A name for finding the form in Ads Manager. People don't see it.
- Headline (`title`, text, required): The headline at the top of the form, up to 25 characters.
- Description (`description`, text, required): What people get for signing up, up to 180 characters.
- Ask for (`questions`, list): 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_questions`, list): 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_url`, text): A link to your privacy policy, starting with https://. Shown on the confirmation screen.
- Consent checkboxes (`consents`, list): Text for up to 2 checkboxes people tick before sending, one per row, such as agreeing to be contacted.
- Checkboxes must be ticked (`consents_required`, true/false): Whether people have to tick the checkboxes to send the form. On by default. Default: `true`.
- Button on the confirmation screen (`end_page_action`, text): 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_url`, text): Where the button goes, starting with https://. Leave empty for no button.

**Outputs**

- `lead_form` (object): A lead generation form

**Example output**

```json
{
  "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_id`, text, required): The ad account. Pick one, or give its id from an earlier step.
- Lead form (`lead_form_id`, text, required): The lead generation form. Pick one, or give its id from an earlier step.
- Webhook (`integration_id`, text, required): The webhook the form sends its leads to. Pick it, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Whether it was deleted
- `form_id` (text): The lead form
- `integration_id` (text): Webhook id

**Example output**

```json
{
  "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_id`, text, required): The ad account. Pick one, or give its id from an earlier step.
- Lead form (`lead_form_id`, text, required): The lead generation form. Pick one, or give its id from an earlier step.

**Outputs**

- `lead_form` (object): A lead generation form

**Example output**

```json
{
  "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_accounts` (list): The ad accounts
- `count` (number): How many

**Example output**

```json
{
  "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_id`, text, required): The ad account. Pick one, or give its id from an earlier step.
- Lead form (`lead_form_id`, text, required): The lead generation form. Pick one, or give its id from an earlier step.

**Outputs**

- `count` (number): How many
- `integrations` (list): The webhooks

**Example output**

```json
{
  "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_id`, text, required): The ad account. Pick one, or give its id from an earlier step.
- Most to return (`limit`, number): How many to return at most. Defaults to 100. From 1 to 1000.

**Outputs**

- `count` (number): How many were returned
- `has_more` (true/false): Whether more forms exist than were returned
- `lead_forms` (list): The lead forms

**Example output**

```json
{
  "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_id`, text, required): The ad account. Pick one, or give its id from an earlier step.
- Lead form (`lead_form_id`, text, required): The lead generation form. Pick one, or give its id from an earlier step.
- Web address (`webhook_url`, text, required): Where each lead is sent, starting with https://.

**Outputs**

- `form_id` (text): The lead form
- `hmac_secret` (text): The key Snapchat signs each delivery with
- `integration_id` (text): Webhook id
- `webhook_url` (text): Where leads are sent

**Example output**

```json
{
  "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_id`, text, required): The ad account. Pick one, or give its id from an earlier step.
- Lead form (`lead_form_id`, text, required): The lead generation form. Pick one, or give its id from an earlier step.
- Webhook (`integration_id`, text, required): The webhook the form sends its leads to. Pick it, or give its id from an earlier step.

**Outputs**

- `integration_id` (text): Webhook id
- `sent` (true/false): Whether Snapchat sent it
- `webhook_url` (text): Where it was sent

**Example output**

```json
{
  "integration_id": "26ed0a8c-27fd-4d28-aec7-9d21bcd0fae1",
  "sent": true,
  "webhook_url": "https://hooks.example.com/snapchat"
}
```
