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

# Tulip

> Connect BonData to Tulip for frontline operations and manufacturing app data

Tulip is a frontline operations platform that lets manufacturers build no-code apps to guide operators, capture production data, and connect machines on the shop floor. With BonData, you can connect to your Tulip workspace to read, enrich, and sync your operations and production data within Agent workflows.

## Tulip API Key Setup

BonData connects to Tulip using a Bot API token, which is an API key and secret pair generated from your workspace settings.

### Step 1: Confirm Your Workspace URL

1. Log in to Tulip
2. Your workspace base URL is the host of your Tulip instance, for example `https://yourcompany.tulip.co`
3. Note this URL - BonData uses it as the base for the Tulip API

### Step 2: Create an API Token (Bot)

1. Go to **Settings** → **API Tokens**
2. Click **Create API Token**
3. Enter a name (for example `BonData`) and select the **scopes** that grant read access to Tables, Apps, and Machines
4. Click **Create**

### Step 3: Copy the API Key and Secret

1. Tulip displays the **API Key** and **Secret** once, on creation
2. **Copy both values immediately** - the secret cannot be retrieved again

<Note>
  Tulip API tokens are scoped per workspace. If you use multiple workspaces, create a token in each workspace you want BonData to access.
</Note>

### Step 4: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **Tulip**
2. Enter your **Workspace URL**, **API Key**, and **API Secret**
3. Click **Connect**

## Required Fields

| Field         | Description                                                            |
| ------------- | ---------------------------------------------------------------------- |
| Workspace URL | Your Tulip workspace host (for example `https://yourcompany.tulip.co`) |
| API Key       | API Key from Settings → API Tokens                                     |
| API Secret    | Secret shown once when the API token is created                        |

## Available Data

Once connected, BonData can sync the following Tulip data:

* **Tables and Records** - Tulip Tables and their records for production and reference data
* **Apps** - App definitions and metadata
* **App Completions** - Completed app runs with captured field values
* **Machines** - Connected machine definitions and attribute data
* **Stations** - Shop-floor stations and their assignments
* **Users** - Operator and workspace user records
