> For the complete documentation index, see [llms.txt](https://docs.fastn.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fastn.ai/build/integrations/connectors/importing-and-exporting.md).

# Importing and exporting

Moving connectors and actions in and out of a workspace as JSON files: Import, exporting actions and exporting connectors.

Connectors and actions can be saved to JSON files and loaded into another workspace. Use this to copy a connector between environments, to keep a copy under version control, or to share a connector definition with someone.

### Export actions

You can export the actions of any connector, managed or owned.

1. Open the connector's detail page.
2. Either tick the actions you want in the connector rail (or **Select all**) and click **Export** in the *n selected* bar, or open one action's **⋯** menu and click **Export**.
3. The browser downloads a JSON file. A bulk export from the rail is named `<connector-slug>-<n>-actions.json`, for example `hubspot-2-actions.json`. Exporting a single action from its **⋯** menu downloads `<action-slug>.json`.

The file looks like this (shortened):

```json
{
  "$schema": "https://fastn.ai/schemas/actions/v1.json",
  "version": "1.0",
  "exportedAt": "2026-10-08T11:28:39.012Z",
  "connector": { "id": "…", "name": "HubSpot", "slug": "hubspot" },
  "actions": [
    {
      "id": "…",
      "name": "Add List Members",
      "slug": "addListMembers",
      "description": "Add records to a MANUAL list. …",
      "httpConfig": { "…": "method, URL, headers, query parameters, body" },
      "ftpConfig": null,
      "redisConfig": null,
      "authConfig": null,
      "inputContract": { "…": "the Input schema" },
      "outputContract": { "…": "the Output schema" },
      "rateLimit": null,
      "stage": "live",
      "version": "v1.2"
    }
  ]
}
```

| Field                              | Meaning                                                                                                                                       |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `connector`                        | The connector the actions came from.                                                                                                          |
| `httpConfig`                       | The request: everything on the Params, Headers and Body tabs. `ftpConfig` and `redisConfig` hold the equivalent for FTP and REDIS connectors. |
| `authConfig`                       | The **Stored action setting** from the Auth tab. It is not used at run time.                                                                  |
| `inputContract` / `outputContract` | The **Input schema** and **Output schema**.                                                                                                   |
| `stage`                            | `test` or `live`.                                                                                                                             |
| `version`                          | The action's version.                                                                                                                         |

An action export holds definitions only: no credentials and no connections.

### Export connectors

Connectors your workspace owns (badged `Custom`) have a **⋯** menu on their catalog card with **Select**, **Edit**, **Export** and **Delete**.

* **⋯ → Export** downloads that one connector as `<slug>-bundle.json`.
* **⋯ → Select** ticks the card and adds **Export Selected (n)** to the page header. Select more cards, then click it to download them together.
* On the connector's detail page, its row in the rail also has a **⋯** menu with **Export All** and **Import**.

**Export Selected (n)** downloads a file named `connectors-bundle-<date>.json`, for example `connectors-bundle-2026-10-08.json`:

```json
{
  "$schema": "https://fastn.ai/schemas/connector-bundle/v1.json",
  "version": "1.0",
  "exportedAt": "2026-10-08T11:56:56.422Z",
  "connectors": [
    {
      "connector": { "name": "Docs Demo CRM", "slug": "docsDemoCrm", "protocol": "REST", "visibility": "private", "authMethods": [], "…": "…" },
      "actions": [ { "name": "List Users", "slug": "listUsers", "httpConfig": { "method": "GET", "url": "https://jsonplaceholder.typicode.com/users" }, "…": "…" } ],
      "webhookConfigs": [],
      "authProviders": [],
      "appRegistrations": []
    }
  ]
}
```

A single-connector `<slug>-bundle.json` is flat: `connector`, `actions`, `webhookConfigs`, `authProviders` and `appRegistrations` sit at the top level, with no `connectors` array.

Each entry carries the connector's definition, its actions, its webhook configs, its auth providers and its app registrations. Connections are never included. If the connector has its own OAuth app, open the file and check the `authProviders` entries before sharing it. Managed connectors do not have this menu; to copy one of their actions, use [Export actions](#export-actions).

### Import

**Create connector → Import from file** on the catalog page opens a file picker (if your role cannot create connectors, the page shows an **Import** button instead). Choose one `.json` file, such as a `connectors-bundle-<date>.json` from [Export connectors](#export-connectors). There is no form to fill in: the file is read and its connectors are created in your workspace as connectors you own.

If a connector in the file already exists in your workspace, fastn asks first:

> **Replace existing connector?**
>
> *\<name>* already exists. Importing will replace its actions and configuration. Saved connections are preserved.

**Replace** overwrites the existing connector's actions and configuration with the file's. Connections on it are kept, so customers do not need to reconnect. **Cancel** stops the import.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fastn.ai/build/integrations/connectors/importing-and-exporting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
