# Setting up Postman for your free trial

{% hint style="success" %}

## Prerequisites

* Access to a free trial tenant[^1] (email with credentials) 
* Read our [](https://docs.fulfillmenttools.com/documentation/using-our-free-trial/free-trial-information "mention") article
* Access to Postman (you can use an HTTP tool of your choice, but for this article, we'll focus on setting up with Postman)
  {% endhint %}

To set up Postman for your free trial, follow the steps below:

{% stepper %}
{% step %}
**Import the fulfillmenttools collection to Postman**

Download the [raw GitHub file](https://raw.githubusercontent.com/fulfillmenttools/fulfillmenttools-api-reference/master/fulfillmenttoolsAPI.postman_collection.json) and add it to the collection section of Postman. 
{% endstep %}

{% step %}
**Create an environment**

Go to the environment section and create a new environment. Add the below to your new environment. Your `projectId` can be found in the email you received from us, which will resemble `ocff-{uniqueID}-dmo`.

<table><thead><tr><th width="298.89453125">Variable</th><th>Value</th></tr></thead><tbody><tr><td><code>projectId</code></td><td>{the project ID in the email you received}</td></tr><tr><td><code>host</code></td><td><code>https://{{projectId}}.api.fulfillmenttools.com/</code></td></tr></tbody></table>
{% endstep %}

{% step %}
**Add credentials to the Postman Vault**

Go to the Postman Vault (bottom right of the Postman screen), and add the below to your Vault. You'll find all the values in the email you received from us (if you've changed the password in Backoffice, use that password instead of the one in the email).

| Variable               | Value                                    |
| ---------------------- | ---------------------------------------- |
| `{projectId}-user`     | {the username in the email you received} |
| `{projectId}-password` | {the password in the email you received} |
| `{projectId}-api-key`  | {the API key in the email you received}  |

{% hint style="info" %}
We use the Postman Vault to store these sensitive variables to avoid syncing them to the Postman Cloud.
{% endhint %}
{% endstep %}

{% step %}
**Make your first API call to get an Auth token**

Go to the fulfillmenttools collection, select `POST Request Auth Token`, ensure your environment is selected, and click **Send**.&#x20;

You should get a `200` response. If you go back to your environment settings, you'll see that an `authToken` and a `refreshToken` have been automatically created.

{% hint style="info" %}
You'll need to run the `POST Refresh Auth Token` endpoint at least every 60 minutes.
{% endhint %}
{% endstep %}
{% endstepper %}

You're now ready to use all the other calls in the collection :tada:

In the next article, we'll take you through facilities. What they are, how to set them up, and how to edit them.

[^1]: An instance of fulfillmenttools for each customer. Each tenant works in different environments. For example, there'll be a tenant for pre-production, and one for production.