Postman API is an API client to help developers test, share and document APIs. This is a useful tool to test sending requests to Merge's API endpoints whenever you're setting up an integration. In this guide, we'll talk about configuring your Postman to send successful requests to the appropriate Merge API endpoints.

Finding required Authentication Keys and request data

To start, you'll need to gather the Base API URL (and endpoints you need to make requests to), Merge Production Access Key, and the permanent account_token you received after adding Merge's integration authentication component to your product.

The linked account token is specific to the particular linked account you're testing with. You can get your account token by using Merge Link (view docs) and saving your token at the end of an integration authentication workflow (as depicted in the diagram below)

The schema for Merge API requests is: https://api.merge.dev/api/<category>/v1/<endpoint>

The Merge base URLs are listed below:

Merge ATS: https://api.merge.dev/api/ats/v1/

Merge HRIS: https://api.merge.dev/api/hris/v1/

Merge Accounting: https://api.merge.dev/api/accounting/v1/

To locate your Production Access Key, head to Configuration in the Merge Dashboard. Once there, click on API Keys. Under Organization Secrets, you will see your Production Access Key which you can copy to your clipboard to use in Postman.

Configuring Postman

Once all the information is gathered, open Postman and create a new HTTP Request. Enter your request URL and the API request method (GET).

Under Authorization, change the Type to Bearer Token and copy the Production Access Key to the token Box.

Under Headers, add in your permanent account_token value under the key X-Account-Token.

Click send! If successful, the response will return a body as shown and a 200 successful HTTP response! Note that the response body varies by API and by request. You can refer to our docs to check out the relevant fields supported by each object and endpoint!

Did this answer your question?