Pipedrive API in Postman or Insomnia
In this guide, we'll give you a basic overview of how to make your first requests to the Pipedrive API using two API testing tools - Postman and Insomnia.
If you prefer to use a different tool, you can always import our Open API 3 specification file to your tool of choice using this URL: https://developers.pipedrive.com/docs/api/v1/openapi.yaml
Keep in mind that we'll occasionally update our Open API 3 specification file, so you might need to re-import it from time to time.
Pipedrive + Postman
If you don't have Postman yet, start by downloading and installing it from https://www.getpostman.com/downloads/.
Once you have Postman installed, you can start adding the Pipedrive API collection by clicking this button:
The easiest way to authorize your requests is to add your
api_token. To do that you will first need to find your API token (see how to do that here).
Next, continue with the following steps:
- To authorize your requests, add your
api_tokento Postman by clicking on the drop-down menu (three-dot icon) next to the collection name.
- Choose "Edit".
- In the new edit screen, click on the "Authorization" tab.
- Add the type of authorization method, the Key (which is
api_token), the value of your
api_tokenand choose "Add to" to be "Query Params".
- Now confirm it all by clicking on "Update".
Now you can make your first requests. Make sure that under the Authorization tab, the authorization type is selected as "Inherit auth from parent".
Pipedrive + Insomnia
If you don't have Insomnia yet, first start by installing it from https://insomnia.rest/download/.
Next, continue with adding the Pipedrive API collection:
- Open Insomnia and click on the small arrow next to "Insomnia". From the drop-down menu choose "Import/Export".
- From the "Import Data" tab choose "From URL" and add the URL of the specification file: https://developers.pipedrive.com/docs/api/v1/openapi.yaml
- Once the Collection has been imported, you will see a small yellow triangle on the left-hand side indicating that no environment has been chosen yet. Choose the "Use OpenAPI env" to get started.
In Insomnia you can use many different authorization methods similar to Postman. These can be added by clicking on the small down-pointing arrow next to the "Auth" tab.
If you want to use your
api_token, it needs to be added as an environment variable.
To add it as an environment variable, first, choose the "Manage environment" from the same drop-down menu where you previously chose to use the OpenAPI environment. Next, add your
api_token to the already existing variables.
api_token's value needs to also include the
?api_token=param in addition to the token as it isn't included in the base URL.
Now you can make your first requests. Make sure to add the
api_token variable to the URL before sending your request.
Updated about 1 month ago