# Postman Collection

Source: https://docs.gocardless.com/docs/developer-resources/postman-collection

# Postman Collection

> **Info:**
> The GoCardless API Collection is hosted in [GoCardless's public Postman
>   workspace](https://www.postman.com/gocardlessapi/workspace/gocardless-api/overview). Fork it
>   directly from there to get started.

## Setup

1. [Create a GoCardless Sandbox account](https://manage-sandbox.gocardless.com/sign-up) — the sandbox is a dedicated testing environment where you can build without touching real money.
2. Go to [Developers → Create → Access Token](https://manage-sandbox.gocardless.com/developers/access-tokens/create) and generate a read-write API access token. **Copy it — you'll need it shortly.**

## Getting started

### Fork the collection

From [GoCardless's public Postman workspace](https://www.postman.com/gocardlessapi/workspace/gocardless-api/overview), fork the GoCardless API collection:

![Fork the Postman collection](/images/docs/developer-resources/postman-collection/screenshot_2023-01-12_at_10.48.52.png)

Enter a name for your fork, select the destination workspace, and check **Watch this collection** to stay up to date with API changes.

### Set up your environment

Create a new environment to store your GoCardless credentials:

![Create a Postman environment](/images/docs/developer-resources/postman-collection/frame_1__1_.png)

Postman environment variables use `}` syntax. Set the `token` variable to the access token you generated earlier:

![Set the token variable](/images/docs/developer-resources/postman-collection/frame_1__3_.png)

Make sure the **GC Sandbox** environment you just created is selected in the Environment dropdown in the top-right corner of Postman before making requests.

### Make a test request

Head to the collection and send any request:

![Make a test request](/images/docs/developer-resources/postman-collection/screenshot_2023-01-12_at_11.03.48.png)

## Notes

- Requests are chained automatically via environment variables — no need to copy and paste IDs between requests.
- Bank account field requirements vary by scheme. See the [local bank details appendix](/docs/api-reference/local-bank-details) for scheme-specific fields.
- Additional query parameters are available for most endpoints. See the [API reference](/docs/api-reference) for the full list.

## What's next?

  
#### [Scenario Simulators](/docs/developer-resources/scenario-simulators)

Trigger payment, mandate, and webhook scenarios in the sandbox.

  
#### [Test Bank Details](/docs/developer-resources/test-bank-details)

Sandbox bank account details for all supported payment schemes.