> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/integrations/postman.md).

# Postman

[Postman](https://www.postman.com/) is an API platform for developers to design, build, test and iterate their APIs. Spark makes it easy to test the generated APIs on Postman. Here is how we recommend it can be done!

Upload the following service to Spark to follow along!

{% file src="/files/fIPPCRCZkFNCiiNQxNgn" %}

## Exporting the cURL Command from Spark

cURL is a computer software project providing a library (libcurl) and command line tool (curl) for transferring data using various network protocols. Start by exporting the cURL command from Spark to import the API data into Postman.

<figure><img src="/files/YFvOLAEYG9SixH3sz8gF" alt=""><figcaption></figcaption></figure>

1. Go to the [API Tester](/navigation/api-tester.md) page for the target service.
2. Click on the *Integration* tab select *Code snippet* and choose the *curl - cURL* option.
3. At the bottom of the page is the option to copy the snippet or download.

## Importing cURL Command into Postman

1. Open the Postman application.

   <figure><img src="/files/EUCBMJrIHBAORIzU5M4s" alt=""><figcaption></figcaption></figure>
2. Click on **Import** in the workspace.

   <figure><img src="/files/gthXhKoJrjBcTviuazSK" alt=""><figcaption></figcaption></figure>
3. If the cURL was downloaded as a file, drag the file into *Drop anywhere to import*.
4. If the cURL was copied as text, paste the text into the textbox.

## Add Authentication to the API Request

Spark provides multiple methods of authentication to be added to an API request.

### Bearer token

![Pasting bearer token into Postman](/files/ZofIRQciWQIMs7YfBWQI)

1. Retrieve the bearer token here, see [Authorization - Bearer token](/spark-apis/authorization-bearer-token.md).
2. Create a new `Authentication` header and paste the bearer token from the previous step.
3. OR Open the API in Postman and open *Authentication* tab.
   1. Select *Bearer token* as option.
   2. Remove the word `Bearer` preceding the Bearer Token paste the field.

### API Key manager `x-synthetic-key`

1. Generate the API key using the procedure mentioned in [Authorization - API keys](/spark-apis/authorization-api-keys.md).
2. Open the API in Postman and open the Headers tab.
3. Ensure the `x-tenant-name` is populated.
4. Create a new header called `x-synthetic-key` and use the key that was previously generated.

![Pasting x-synthetic-key in Postman](/files/NqxhlZG9k2MXV1AhSjR9)

## Checking API Response

![API response body in Postman](/files/SlfoHd2XQktRPLO0aF9Y)

1. The API request can be sent to Spark by clicking the **Send** button.
2. The API response can be checked using the *Body* tab of the interface.
3. The response codes (HTTP status codes) generated by Spark can be referenced in [Execute API (v3)](/spark-apis/execute-api/execute-api-v3.md#http-status-code).
