> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withorb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Postman

## Prerequisites

* An active Orb account
* Access to your Orb API key [here](https://app.withorb.com/settings?tab=api_keys)
* A free [Postman Account](https://identity.getpostman.com/signup)

## Setup

Import the Orb collection into Postman. You can [download the Postman application](https://www.postman.com/downloads/).
Orb recommends forking the collection so you can safely add your API key:

[![Run in Postman](https://run.pstmn.io/button.svg)](https://god.gw.postman.com/run-collection/20577229-2cfaecbf-54a1-48ec-b012-3bb037213253?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D20577229-2cfaecbf-54a1-48ec-b012-3bb037213253%26entityType%3Dcollection%26workspaceId%3D7728bdfa-2fdb-408d-91bc-bef873cb9715)

### Postman environment setup

A full list of available Orb API calls is structured by resource in the left sidebar. In the left sidebar, you can click on the menu button to view the documentation for the given folder or specific API request.

#### Authentication

<Tip>
  Before you generate an API Key, you'll want to enable test mode in the top left of the Orb UI. Test mode gives you a safe playground that doesn't affect your production customers or data.
</Tip>

This collection includes a Postman "Environment" called "Test Mode". In the Orb UI, you'll want to head over to the API Keys tab in the settings page [here](https://app.withorb.com/settings?tab=api_keys) to generate an API Key. Once you have that:

1. Navigate to the environment by clicking the "Environments" tab on the left side, and clicking the "Test Mode" environment.
2. Fill in the api\_key with your API key
   * Variables allow you to share values within the collection.
   * To learn more about Postman variables, see the [documentation](https://learning.postman.com/docs/sending-requests/variables/).

## Working with the collection

After setup is complete, you are ready to begin making API calls. In the Orb API Reference folder, there are subfolders for each type of API resource listed in the [Orb API Reference](/api-reference). Expand the subfolders to see the HTTP methods and API call names.