> For the complete documentation index, see [llms.txt](https://docs.geniesolutions.io/genie-partner-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.geniesolutions.io/genie-partner-api/tutorials-and-examples/connecting-with-postman/setup-and-config.md).

# Setup and Config

The steps in this section will guide you through the process of downloading the Postman collection and configuring the OAuth2 details with your personal login details.

#### Step 1: Download the Postman Application

If you haven't already got Postman installed locally, [navigate to the Postman website](https://www.postman.com/) and download the version of the application for your operating system.

#### Step 2: Download the Postman Collection

The Postman collection can be downloaded from our resources page [here](/genie-partner-api/downloadable-resources/getting-started.md). 

#### Step 3: Import the collection in to Postman

To use the collection you will need to import it in to Postman first. \
Within the Postman application click the `Import` button to the right of 'My Workspaces' and then use the `File` browser to locate the postman collection `.json` file on your computer.

![](https://3515076773-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FttPXu7KkPJyal5N8Wjfa%2Fuploads%2FE4BjUcta4fnUz2SSzzQf%2FScreen%20Shot%202022-06-23%20at%202.22.43%20pm.png?alt=media\&token=6bc94fa4-9bff-4ff3-8444-ca7404d9037e)

#### Step 4: Configure your Global Variables

Postman uses variables that allows the use of placeholders within requests and parameters to remove the need to copy and paste values in to multiple places for multiple requests.

The key variables you will need to do requests to the Partner API are `API_URL`,`API_KEY AUTH_URL, TOKEN_URL, CLIENT_ID`

To set these variables so they can be accessed easily by your requests go to the `ENVIRONMENTS` tab within Postman and click on the `+` button to create a new environment or import the empty environment file from our resources page [here](/genie-partner-api/downloadable-resources/getting-started.md).

In the table to the right of where you added the environment name, add the variable `API_URL` and then in both the **Initial Value** and **Current Value** columns add the URL to the Partner API server which was specified by Genie, for example:  

{% tabs %}
{% tab title="API URL" %}
<https://api.example.geniesolutions.io>
{% endtab %}
{% endtabs %}

Then in the row below the **API\_URL** add the variable **API\_KEY** and in both the **Initial Value** and **Current Value** columns add the **API\_KEY** you received when creating your Partner API account.&#x20;

{% tabs %}
{% tab title="API KEY" %}
vhwln9AUoX6uXl6Iv9gtInywovORD8l1hADu4DS4
{% endtab %}
{% endtabs %}

Add the AUTH\_URL variable, and in both initial value and current value add the auth url you received from Genie, for example:

{% tabs %}
{% tab title="AUTH URL" %}
<https://auth.example.geniesolutions.io/oauth2/authorize>
{% endtab %}
{% endtabs %}

Add the TOKEN\_URL variable, and in both initial value and current value add the token url you received from Genie, for example:

{% tabs %}
{% tab title="TOKEN URL" %}
<https://auth.example.geniesolutions.io/oauth2/token>
{% endtab %}
{% endtabs %}

Add the CLIENT\_ID variable, and in both initial value and current value add the client id you received from Genie, for example:

{% tabs %}
{% tab title="CLIENT ID" %}
3o5g7uaic8og50e88ljsem8iau
{% endtab %}
{% endtabs %}

{% hint style="info" %}
If you have misplaced this key or don't have a Partner API account please contact the team at Genie.
{% endhint %}