# Header

## Introduction

Any key pairs added to the **header** tab are passed into authentication request headers - for example: 

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F8FmP79ErOqNVikqCw94U%2Fheader%201.png?alt=media&#x26;token=b18ace09-b2b6-4dbd-8f5d-371ef315ca02" alt=""><figcaption></figcaption></figure></div>

In this example, we've already defined two [auth variables](https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector/3-authentication-methods/authentication-method-options/auth-variables) for **username** and **password**, so users will be prompted to enter these details when [adding an instance](https://doc.wearepatchworks.com/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance) of this connector for use in [process flows](https://doc.wearepatchworks.com/product-documentation/process-flows/about-process-flows).&#x20;

How we then pass this information into API requests is determined by the API documentation for the underlying third-party application. Often, these details are passed in request **headers**, but sometimes it will be via the request [body](https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector/3-authentication-methods/authentication-method-options/body).&#x20;

By adding these as key pairs to the **header**, we pass any values provided for these fields in the authentication request headers.

You should refer to the authentication section of your your API documentation for specific guidance about what (if any) values need to be passed in authentication request headers. For example, in Shopify, it's noted that we need to send two values in the request header - `Content-Type` and `Shopify-Access-Token`:

<figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FTwSpGOxSjAlWfJkPP8qV%2FShopify%20docs%20headers.png?alt=media&#x26;token=0aec65fc-7cdc-4e67-8ef3-43280caed801" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
When an authentication method is applied for an endpoint, any header/body parameters specified for the authentication method are also sent in the endpoint requests.
{% endhint %}

## Adding header parameters

**Header** parameters are added as key pairs. To add a **header** parameter, follow the steps below:

**Step 1:**\
Click the **add new header** button:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2F4vD5Q1Pzev9Adf8xKdlO%2Fheader%202.png?alt=media&#x26;token=b5e8bf04-e693-4ed8-8bb9-0b907fa3b7f5" alt=""><figcaption></figcaption></figure></div>

**Step 2:**\
Complete key pair details as required and save changes:

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FjhwZ3rxIlj5VUkpoYF5F%2Fheader%203.png?alt=media&#x26;token=62381a32-fdbc-48ab-93a1-182d1537438a" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
The **add option** page is the same for all types of parameters that you may encounter in the connector builder. For information about these options please see the [Working with parameters ](https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector/techniques-for-working-with-variables-and-parameters/working-with-parameters)page.

For guidance on configuring parameters for specific **authentication types**, please see our [Supported authentication types](https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector/3-authentication-methods/supported-authentication-types) section.
{% endhint %}

## Editing & removing header parameters

**Header** parameters are standard key pairs - techniques for working with these parameters are the same as those for working with body parameters, URL parameters, etc. For more information about these techniques, please see the [Working with parameters ](https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector/techniques-for-working-with-variables-and-parameters/working-with-parameters)page.