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

# connectors pull

> Pull connector configurations from Base44 to local files

Download [connector configurations](https://docs.base44.com/developers/backend/resources/connectors/shared-connectors.md) from Base44 to local `.jsonc` files. The command fetches all connectors and saves them to your connectors directory, one file per connector. By default the connectors directory is `base44/connectors/`, but you can customize the path in your [project configuration](https://docs.base44.com/developers/backend/overview/project-structure.md#config-jsonc).

> [!WARNING]
>
> This is a full sync. Local connectors not present remotely will be deleted. See the Sync behavior table below for details.

## Usage

```bash theme={null}
base44 connectors pull
```

## Flags

| Flag | Description |
| - | - |
| `--dir <path>` | Directory to write connector files to. Defaults to the connectors directory of the linked project, or `./connectors` when you target an app with `--app-id`. |
| `--json` | Output the sync result as JSON. See [JSON output](https://docs.base44.com/developers/references/cli/commands/introduction.md#json-output). |

## Sync behavior

| Remote state | Local state | Result |
| - | - | - |
| Connector exists | Connector exists | Local file is replaced with remote. |
| Connector exists | Connector doesn't exist | Local file is created. |
| Connector doesn't exist | Connector exists | Local file is deleted. |

## See also

* [`connectors push`](https://docs.base44.com/developers/references/cli/commands/connectors-push): Push local connector configurations to Base44
* [`connectors initiate`](https://docs.base44.com/developers/references/cli/commands/connectors-initiate): Set up a single connector and start its OAuth flow
* [Shared connectors](https://docs.base44.com/developers/backend/resources/connectors/shared-connectors.md): Learn how to configure connectors
* [Using Connectors](https://docs.base44.com/Integrations/Connectors.md): Guide to using connectors in your app


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