# Airtable Bases

Blocks for creating and managing Airtable bases, which are the top-level containers for tables, records, and data in Airtable.

## Airtable Create Base

### What it is

Create or find a base in Airtable

### How it works

This block creates a new Airtable base in a specified workspace, or finds an existing one with the same name. When creating, you can optionally define initial tables and their fields to set up the schema.

Enable find\_existing to search for a base with the same name before creating a new one, preventing duplicates in your workspace.

### Inputs

| Input          | Description                                                                                                                                         | Type                   | Required |
| -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- | -------- |
| workspace\_id  | The workspace ID where the base will be created                                                                                                     | str                    | Yes      |
| name           | The name of the new base                                                                                                                            | str                    | Yes      |
| find\_existing | If true, return existing base with same name instead of creating duplicate                                                                          | bool                   | No       |
| tables         | At least one table and field must be specified. Array of table objects to create in the base. Each table should have 'name' and 'fields' properties | List\[Dict\[str, Any]] | No       |

### Outputs

| Output       | Description                                                 | Type                   |
| ------------ | ----------------------------------------------------------- | ---------------------- |
| error        | Error message if the operation failed                       | str                    |
| base\_id     | The ID of the created or found base                         | str                    |
| tables       | Array of table objects                                      | List\[Dict\[str, Any]] |
| table        | A single table object                                       | Dict\[str, Any]        |
| was\_created | True if a new base was created, False if existing was found | bool                   |

### Possible use case

**Project Setup**: Automatically create new bases when projects start with predefined table structures.

**Template Deployment**: Deploy standardized base templates across teams or clients.

**Multi-Tenant Apps**: Create separate bases for each customer or project programmatically.

***

## Airtable List Bases

### What it is

List all bases in Airtable

### How it works

This block retrieves a list of all Airtable bases accessible to your connected account. It returns basic information about each base including ID, name, and permission level.

Results are paginated; use the offset output to retrieve additional pages if there are more bases than returned in a single call.

### Inputs

| Input   | Description                                 | Type | Required |
| ------- | ------------------------------------------- | ---- | -------- |
| trigger | Trigger the block to run - value is ignored | str  | No       |
| offset  | Pagination offset from previous request     | str  | No       |

### Outputs

| Output | Description                                  | Type                   |
| ------ | -------------------------------------------- | ---------------------- |
| error  | Error message if the operation failed        | str                    |
| bases  | Array of base objects                        | List\[Dict\[str, Any]] |
| offset | Offset for next page (null if no more bases) | str                    |

### Possible use case

**Base Discovery**: Find available bases for building dynamic dropdowns or navigation.

**Inventory Management**: List all bases in an organization for auditing or documentation.

**Cross-Base Operations**: Enumerate bases to perform operations across multiple databases.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://agpt.co/docs/integrations/block-integrations/bases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.