# TikTok Lead Generation

> Retrieve TikTok Instant Form and direct-message leads, manage test leads, and start regional lead export jobs.

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

## Actions

### Create lead export

Create lead export.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Page (`page_id`, text): Page id.
- Ad id (`ad_id`, text): Ad id.
- Lead region (`lead_region`, text): Lead region. One of: `eu`, `us`.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### Create test lead

Create test lead.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Lead source (`lead_source`, text): Lead source. One of: `INSTANT_FORM` (Instant form), `DIRECT_MESSAGE` (Direct message).
- Page (`page_id`, text): Page id.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### Delete test lead

Delete test lead.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Lead id (`lead_id`, text, required): Lead id.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### Get latest lead

Get latest lead.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Lead source (`lead_source`, text): Lead source. One of: `INSTANT_FORM` (Instant form), `DIRECT_MESSAGE` (Direct message).
- Page (`page_id`, text): Page id.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### Get lead export status

Get lead export status.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Page (`page_id`, text): Page id.
- Ad id (`ad_id`, text): Ad id.
- Lead region (`lead_region`, text): Lead region. One of: `eu`, `us`.
- Task id (`task_id`, text, required): Task id.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### Get lead fields

Get lead fields.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Lead source (`lead_source`, text): Lead source. One of: `INSTANT_FORM` (Instant form), `DIRECT_MESSAGE` (Direct message).
- Page (`page_id`, text): Page id.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### Get test lead

Get test lead.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Lead source (`lead_source`, text): Lead source. One of: `INSTANT_FORM` (Instant form), `DIRECT_MESSAGE` (Direct message).
- Page (`page_id`, text): Page id.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### List form libraries

List form libraries.

**Inputs**

- Page (`page`, number): Page. At least 1.
- Page size (`page_size`, number): Page size. From 1 to 100.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```

### List instant forms

List instant forms.

**Inputs**

- Advertiser id (`advertiser_id`, text): Advertiser id.
- Library id (`library_id`, text): Library id.
- Page (`page`, number): Page. At least 1.
- Page size (`page_size`, number): Page size. From 1 to 100.
- Status (`status`, text): Status. One of: `EDITED`, `PUBLISHED`.
- Title (`title`, text): Title.

**Outputs**

- `data` (object): Tik Tok Lead Generation response data.

**Example output**

```json
{
  "data": {}
}
```
