> For the complete documentation index, see [llms.txt](https://interworky.gitbook.io/interworky-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://interworky.gitbook.io/interworky-docs/features-overview/capabilities/importing-custom-capabilities-via-postman-collection.md).

# Importing Custom Capabilities via Postman Collection

When integrating your API with Interworky via a Postman Collection, it’s important to follow these guidelines to ensure a smooth import process

<figure><img src="https://3900551154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh8KeqaWePL624uIZ0FlH%2Fuploads%2Fw7IDc05gLxZBxiLsfdV7%2Finterworky-postman-custom-capability.png?alt=media&amp;token=8f4c85a3-a232-4ef3-9ef6-a3a7aae63854" alt=""><figcaption><p>Importing Custom Capabilities via Postman Collection</p></figcaption></figure>

### Exporting Your Postman Collection

* File Format:

  * Make sure your Postman Collection is exported as a JSON file.

* Version:
  * Export your collection as `v2.1`. This is the supported version for Interworky imports.

### Configuring Environment Variables

Your Postman Collection may include dynamic values, such as the host URL for different environments (e.g., development, staging, production).&#x20;

<figure><img src="https://3900551154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fh8KeqaWePL624uIZ0FlH%2Fuploads%2FMUdErnzyf6sBfHJE0b8z%2Finterworky-postman-variables.png?alt=media&amp;token=9ce95416-121a-46b5-821c-327cb43ae7ee" alt="" width="375"><figcaption><p>Adding your POSTMAN host/base_url environment variable</p></figcaption></figure>

To handle this Use **Variables**:

Instead of hardcoding the host URL in your API endpoints, use a variable. For example, For your host you might use: {{baseURL}}&#x20;

* **Defining the Variable:**

In your Postman environment or collection, define:

* Variable Name: baseURL
* Variable Value: The corresponding URL for your desired environment (e.g., <https://dev.interworky.com> or <https://productionserver.mywebsite.com>).

{% hint style="info" %}
Local environments might not work properly with this configuration. Ensure you use a URL that’s accessible from the internet, such as your staging or production domain
{% endhint %}

<br>
