> For the complete documentation index, see [llms.txt](https://doc.wearepatchworks.com/product-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector.md).

# Building your own connector

## Introduction

The connector builder walks you through a series of configuration pages so you can complete all required setup that's needed to make your connector available in Patchworks.

Once your connector is built, it is displayed in the [Patchworks marketplace](/product-documentation/marketplace/the-patchworks-marketplace.md), so users **associated with your company profile** can add [instances](/product-documentation/connectors-and-instances/working-with-instances.md) of it.

{% hint style="info" %}
Prebuilt connectors must be installed before instances can be added for them. However, when you build your own connector it's automatically installed, ready for instances to be added.
{% endhint %}

## Preparation

Before you start work with the connector builder, make sure that you have the API documentation to hand for whichever third-party application you're building.

We also recommend that you fire up [Postman](https://www.postman.com/), so you can test any API requests that you're adding to the connector builder.

## Required setup

As you step through the connector builder, you are prompted to complete the following configuration steps.

{% hint style="info" %}
Make sure that you have the API documentation to hand for whichever third-party application you're building!
{% endhint %}

<details>

<summary><img src="/files/lEJVjx8Wl8aiVinNFHeA" alt="" data-size="line"> Basic details</summary>

Provide a name and other basic details for your new connector. For guidance on completing this page please see [1: Basic details](/product-documentation/developer-hub/connector-builder/building-your-own-connector/1-basic-details.md).

![](/files/RcWEjhSGtq0boXs6Eg6w)

</details>

<details>

<summary><img src="/files/ZwrogWXqyYBC1NviEd7W" alt="" data-size="line"> Variables</summary>

Add variables that you might use in multiple places in your connector setup (i.e. variables used for authentication method and endpoint configuration). For guidance on completing this page please see [2: Connector variables](/product-documentation/developer-hub/connector-builder/building-your-own-connector/2-connector-variables.md).

![](/files/SuzIe0KjxOCzW6ASo3Ai)

</details>

<details>

<summary><img src="/files/OSjC4DiAICgGHd7vjtps" alt="" data-size="line"> Authentication methods</summary>

How would you like users to authorise any instances that they add for this connector? Every connector requires at least one authorisation method. For guidance on completing this page please see [3: Authentication methods](/product-documentation/developer-hub/connector-builder/building-your-own-connector/3-authentication-methods.md).

![](/files/9Fp4IS2O2H7cnWxazvAy)

</details>

<details>

<summary><img src="/files/c83han8bx81qgc2tfFR9" alt="" data-size="line"> Endpoints</summary>

Define the API requests for any endpoints you want to make available for this connector. For example, if you want to pull/push products then you'll need a 'products' endpoint; if you want to pull/push orders then you'll need an 'orders' endpoint, etc. For guidance on completing this page please see [4: Endpoints](/product-documentation/developer-hub/connector-builder/building-your-own-connector/4-endpoints.md).

![](/files/urrzsNcG08BKIMJFD9mJ)

</details>