> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frontic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger Fetch List

Trigger Frontic to pull a **list** of records from the external system. Useful for webhook-style triggers like "this category changed - re-pull everything in it" where Frontic fans out the fetch through its connector.

Two requirements:

* The Data Feed must be configured with method **trigger** or **polling** (not **ingest**).
* The integration's connector must support listing fetches (`FetchListAwareInterface` in source). Not every integration implements this - a `/fetch-list` call to a connector that doesn't support it is still accepted with a `200`, but nothing is fetched.

## Path Parameters

**integration-id** `string` *required*

Your integration identifier. Found in the admin app under integration settings.

**feed-token** `string` *required*

Your Data Feed's token, which is the value in the feed's Ingest URL. The feed also has a separate `id`; the token is the one that belongs in the URL. Find it in the admin app under your feed settings.

## Request Body

The body is a trigger signal - it identifies which list to fetch. The exact shape depends on your integration's connector; typical patterns include a parent identifier (e.g. a category ID) or a query filter.

**id** `string`

Identifier for the list scope (e.g. a category ID). Specific connectors may accept additional fields.

## Response

**correlation-id** `string` *required*

Unique identifier to track the fetch through the processing pipeline.

```json Trigger Body theme={"theme":"css-variables"}
{
  "id": "category-shoes"
}
```

```json 200 OK theme={"theme":"css-variables"}
{
  "correlation-id": "66g2i0h1-6e06-8i52-c5e9-77g64b113b1b"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.