# Body

## Introduction

Any key pairs added to the **body** tab are passed into the request body for authentication requests  - for example:&#x20;

<div align="left"><figure><img src="https://2440044887-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLYNcUBVQwSkOMG6KjZfz%2Fuploads%2FVo5qETuTWRHTEEt6lcOF%2Fbody%201.png?alt=media&#x26;token=e83ce3e0-b8bd-4428-af28-6d0f3a8685b5" alt=""><figcaption></figcaption></figure></div>

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

In this example, we need to pass a number of credentials for OAuth 2 authorisation into the body. Notice that the values in this example are defined as variables. We've already defined [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 these items, which means 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). So, required body parameter values will use values that users have provided when the instance being used was created.

{% hint style="info" %}
Please refer to the authentication section of your API documentation for specific guidance about what (if any) values need to be passed in the authentication body.
{% endhint %}

## Adding body parameters

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

**Step 1:**\
Click the **add new required body parameter** button.

**Step 2:**\
Complete key pair details as required and save changes - 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%2Fe30jRCPOQnsUPxXQCFU5%2Fbody%202.png?alt=media&#x26;token=328cb40a-40e3-499b-9443-352e3abe569a" 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 body parameters

**Body** parameters are standard key pairs - techniques for working with these parameters are the same as those for working with header 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.
