Setting up Postman for your free trial

Prerequisites

• Access to a free trial tenant (email with credentials)

• Read our Free trial information 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)

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

1

Import the fulfillmenttools collection to Postman

Download the raw GitHub file and add it to the collection section of Postman.

2

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.

Variable	Value
projectId	{the project ID in the email you received}
host	https://{{projectId}}.api.fulfillmenttools.com/

3

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}

We use the Postman Vault to store these sensitive variables to avoid syncing them to the Postman Cloud.

4

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.

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.

You'll need to run the POST Refresh Auth Token endpoint at least every 60 minutes.

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

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