> AI agents: this is one page from Mammoth Analytics documentation. The index of all pages as Markdown is https://mammoth.io/docs/llms.txt. Append `.md` to any docs URL, or send `Accept: text/markdown`, to get Markdown.

# Connect an API source in Mammoth

> Connect any of the API sources the Mammoth agent already knows: pick it in the launcher, give the key or sign in, pick tables and columns, and save a dataset that refreshes.
>
> Applies to: Roles: Project Admins create connections; Project Editors start datasets from existing ones. Where: Data Library › New dataset › Connectors

Every source on the [API sources list](https://mammoth.io/docs/learn/get-data-in/api-sources/) connects the same way: you pick it in the launcher, give the key or sign in, and the agent lists what it can read.

## Connect the source

1. In the **Data Library**, click **New dataset** and choose **Connectors** (or go to **Data → Connections** and click **New Connection**).
2. Type the source's name and pick it, or find it under its category in the left menu. The connector workspace opens with the chat on the left.
3. If the chat asks for anything first, such as your site address or region, answer it. The **Have ready** column on the [API sources list](https://mammoth.io/docs/learn/get-data-in/api-sources/) says what that will be.
4. The chat shows a **Connect** card for the key, token or sign-in the source needs, with a link to the source's own page for making one. Fill it in and click **Test and connect**. For a source that signs in with Mammoth's own app, click **Sign in with ...** and approve access on the source's page.
5. Where the agent already knows the source's tables, the **Tables** list shows them before you connect, marked **not read yet**. Once the key works, the agent reads each one and lists any others it finds.

![Connect Stripe card asking for an API key, with Create a key in Stripe, Test and connect, and Someone else has the key, beside the Tables list from the Stripe guide](https://mammoth.io/docs/images/20261117_stripe-key-card.webp)

If someone else holds the key, use **Someone else has the key?** on the card: enter their email and click **Send**, or copy the link. They paste the key on a Mammoth page and you never see it. The link works for 7 days.

> **Your key stays out of the chat**
>
> The key is saved to the connection. The agent never sees it, and it is never written into the chat.

## Pick tables and save the dataset

1. Click a table to see its columns and sample rows, and tick the columns you want. They gather in **Your table**.
2. Ask the chat for anything missing, for example a field from another table.
3. Click **Preview 100 rows** to check the result.
4. Click **Save as dataset**, enter a **Dataset name**, choose a folder under **Save in**, and under **Keep it up to date** choose **Daily** or **Manual**. Then click **Save**.

Choosing **Daily** creates a [Dataset Refresh](https://mammoth.io/docs/learn/automate/refresh-a-dataset/) automation.

## Where to find your key

Each row on the [API sources list](https://mammoth.io/docs/learn/get-data-in/api-sources/) names the kind of key under **How you sign in**. The card's **Create a key in ...** link opens the source's own page for making one, with the menu path beside it. Give the key read access to the data you want; the agent tells you if the key can't read a table.

## Refreshing

Sources marked **Yes** under **New rows only** fetch just what changed since the last run. For the rest, the agent checks for a field that marks new rows while it builds the connection; without one, each refresh fetches everything.

## Related

- [API sources the agent knows](https://mammoth.io/docs/learn/get-data-in/api-sources/): every source this page covers.
- [REST API](https://mammoth.io/docs/learn/get-data-in/connectors/rest-api/): connect an API that isn't on the list.
- [Connector workspace](https://mammoth.io/docs/learn/get-data-in/connector-workspace/): the chat, the Tables list and what each table status means.

---
Source: https://mammoth.io/docs/learn/get-data-in/connect-an-api-source.md · Updated: 2026-11-17
