# Body

## Introduction

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

<div align="left"><figure><img src="/files/VcTRQiDS55Cjyj9vjxdD" 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](/product-documentation/developer-hub/connector-builder/building-your-own-connector/3-authentication-methods/authentication-method-options/auth-variables.md) for these items, which means users will be prompted to enter these details when [adding an instance](/product-documentation/connectors-and-instances/working-with-instances/adding-an-instance.md) of this connector for use in [process flows](/product-documentation/process-flows/about-process-flows.md). 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="/files/pKuKaKfvN3afNLrepaHH" 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 ](/product-documentation/developer-hub/connector-builder/building-your-own-connector/techniques-for-working-with-variables-and-parameters/working-with-parameters.md)page.

For guidance on configuring parameters for specific **authentication types**, please see our [Supported authentication types](/product-documentation/developer-hub/connector-builder/building-your-own-connector/3-authentication-methods/supported-authentication-types.md) 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 ](/product-documentation/developer-hub/connector-builder/building-your-own-connector/techniques-for-working-with-variables-and-parameters/working-with-parameters.md)page.


---

# Agent Instructions: 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:

```
GET https://doc.wearepatchworks.com/product-documentation/developer-hub/connector-builder/building-your-own-connector/3-authentication-methods/authentication-method-options/body.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.