# Get records from an external data source

> In the Tadabase AI workflow editor, read rows from an External Source view, endpoint or built-in list such as Stripe, then loop over them in later steps.

Source: https://tadabase.com/docs/workflows/get-records-from-an-external-source  
Status: Verified Nov 17, 2026. Checked against the current product

The **Get Records from an External Source** action reads rows from an app you connected under [External Sources](https://tadabase.com/docs/integrations/show-live-data-from-external-sources), such as Stripe, Airtable or HubSpot, while a workflow runs. Use it with a loop to create or update one Tadabase record per outside row, for example to copy a customer's Stripe subscriptions into a table.

> **Where to find it:** This action is in the workflow editor of the Tadabase AI builder, with the record actions such as Find Records. The classic builder's workflow editor does not offer it. It works with any trigger; you do not need the External Data Source trigger.

## Before you start

Connect the outside app first, and save a view of the rows you want if you plan to read a view. See [Show live data from Airtable, Stripe, HubSpot and more](https://tadabase.com/docs/integrations/show-live-data-from-external-sources). External sources are part of the Business Pro and Business Elite plans; on other plans the step fails when the workflow runs.

## Set it up

1. **Add the action** Add a step and choose **Get Records from an External Source**.
2. **Choose what to read** Under **Read from**, pick **A saved view** (its account, list, filters and columns come from the view), **One of an account's endpoints** (a path you added on a connected account), or **A built-in list** (a list the app offers, such as Stripe subscriptions).
3. **Pick the view, or the account and list** For a saved view, choose it under **View**. Otherwise choose the **Account**, then the **Endpoint** or the list.
4. **Add parameters (optional)** Under **Parameters**, click **Add parameter**, type the parameter name, such as `customer`, and choose its value, such as the Stripe id field of the trigger record. A parameter also fills a `{name}` placeholder in an endpoint path.
5. **Set the limits** **Follow every page** reads all pages of the list, up to the limit; turn it off to read only the first page. **Limit** is the most records the step returns, up to 5,000 (default 500). Turn on **Fail when nothing is found** to stop the workflow on an empty result; when it is off, the workflow carries on with an empty list.
6. **Load a sample row** Under **Sample row**, click **Load sample**. One row is read so a loop over the records can offer its fields.

## Use the records in later steps

The step returns **records** (the list of rows), **count** and **first** (the first row). To act on every row, add a loop whose source is this step's records, then add the steps to run for each row inside the loop, for example a Create Record step that maps fields from the loop item. See [Repeat steps for each item with a loop](https://tadabase.com/docs/workflows/repeat-steps-with-a-loop).

If the rows came back cut short by the limit, the run history says Records: and the number, with stopped at the limit.

## This action or the External Data Source trigger?

The **External Data Source** trigger runs a workflow for one outside record, when someone clicks a button on that record in an External Source view. This action reads many rows during any workflow, such as a scheduled one. See [Workflow triggers](https://tadabase.com/docs/workflows/workflow-triggers).

## Common problems

- **The External Source view this step reads no longer exists.** The saved view was deleted. Pick another view.
- **The connected account this step reads from no longer exists.** Reconnect the account and choose it again.
- **No rows came back** when you load a sample. If the source needs a parameter, the sample is read without it; the step reads with the parameter when the workflow runs.
