> 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/connectors/creating-a-connector.md).
# Creating a connector
The Create connector dialog: identity, connection and authentication in one place.
**Create connector** opens a dialog with three sections: **Identity**, **Connection** and **Authentication**.
Create connector stays disabled until the name is filled, the footer says so.
| Field | Type | Notes |
| --------------- | ------ | ----------------------------------------------------------------------------------- |
| **Name** | text | Required. What people see. Placeholder `Salesforce`. |
| **Slug** | text | Required. *Derived from the name. Edit it to override.* Used in API paths and code. |
| **Description** | text | Optional, but the agent reads it when deciding what a connector is for. |
| **Protocol** | select | Required. `REST` (default), `MCP`, `FTP`, `Database`, `REDIS`. |
| **Visibility** | select | Offers only `Private`: publishing a connector publicly is a platform-admin action. |
| **Domain** | text | Optional. The vendor's domain, e.g. `salesforce.com`. |
| **Icon URL** | text | Optional. Shown on the card and in the widget. |
Authentication is set up **in the same dialog**, not afterwards. **Add method** adds one; each method has a type:
| Type | Internal value |
| ------------------- | -------------- |
| No Auth | `NO_AUTH` |
| Basic Auth | `BASIC` |
| Digest Auth | `DIGEST` |
| Bearer Token | `BEARER` |
| API Key | `API_KEY` |
| OAuth 2.0 (default) | `OAUTH_2` |
| Custom | `INPUT` |
Those internal values are worth knowing because some of them surface raw in the `Auth` column on [Connections](/build/connections.md).
Each method also carries a **Set as default** radio, an **Authentication docs URL(optional)** field, a **Use Dynamic Client Registration (DCR)** checkbox (RFC 7591), and an **Additional OAuth Config(optional)** key/value repeater. Choosing Basic Auth or API Key swaps in a **Configuration** section with a `Form` / `JSON` toggle and a key/value repeater.
The dialog footer will not let you save until the connector is named: the hint reads *Give it a name to continue.*
{% hint style="info" %}
You rarely need to do this by hand. Describe the system to the [Agent](/build/agent.md) and give it a spec URL or an OpenAPI file. It will discover the actions, build the connector, and test it.
{% endhint %}
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.fastn.ai/build/connectors/creating-a-connector.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
