> ## 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 push

> Push local connector configurations to Base44

Upload local [connector configurations](https://docs.base44.com/developers/backend/resources/connectors/shared-connectors.md) to Base44. The command reads all `.json` and `.jsonc` files in your connectors directory, then adds or updates each one on Base44. 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).

After pushing, the CLI handles each connector based on its type:

* **OAuth connectors** require browser-based authorization. The CLI prompts you to authorize each one sequentially, suggesting to open your browser automatically. You can also use the displayed OAuth URLs to authorize manually. You can push without completing authorization, but the connector won't be usable until you do. Run `connectors push` again later to complete it. If you push a connector with the same scopes it already has, you won't need to reauthorize.
* **Stripe** is provisioned automatically. The CLI creates a Stripe sandbox for your app and returns a claim URL to complete onboarding. No OAuth flow is needed.

> [!NOTE]
>
> Connectors cannot be created or configured through the Base44 dashboard. You must define them in local configuration files and push them using the CLI.

## Usage

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

## Flags

| Flag | Description |
| - | - |
| `--dir <path>` | Directory to read connector files from. Defaults to the connectors directory of the linked project, or `./connectors` when you target an app with `--app-id`. |
| `--force` | Remove connectors on Base44 that aren't in your local files. If your connectors directory is empty, nothing is removed. |
| `-y, --yes` | Skip the confirmation prompt for `--force`. |
| `--json` | Output the sync result as JSON. See [JSON output](https://docs.base44.com/developers/references/cli/commands/introduction.md#json-output). |

> [!WARNING]
>
> The `--force` flag removes every connector on Base44 that isn't in your local files, including connectors you set up with [`connectors initiate`](https://docs.base44.com/developers/references/cli/commands/connectors-initiate) or the [Apps API](https://docs.base44.com/developers/references/apps-api/sections/integrations.md). Removing Stripe deletes its sandbox, keys, and claim link. Functions that use a removed connector fail until you set it up again.

## Sync behavior

The command adds and updates connectors, and only removes them when you pass `--force`:

| Local state | Remote state | Result |
| - | - | - |
| Connector exists | Connector exists | Remote connector scopes are updated. |
| Connector exists | Connector doesn't exist | New connector is created. OAuth connectors require authorization; Stripe is provisioned automatically. |
| Connector doesn't exist | Connector exists | Remote connector is left unchanged. With `--force`, it's removed. |

## See also

* [Shared connectors](https://docs.base44.com/developers/backend/resources/connectors/shared-connectors.md)
* [`connectors initiate`](https://docs.base44.com/developers/references/cli/commands/connectors-initiate)
* [deploy](https://docs.base44.com/developers/references/cli/commands/deploy.md)
* [SDK connectors module](https://docs.base44.com/developers/references/sdk/docs/interfaces/connectors.md)
* [Using Connectors](https://docs.base44.com/Integrations/Connectors.md)


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