# Insomnia Collection
source: https://developer.mastercard.com/issuer-enrollment/documentation/insomnia-collection/index.md

Use Insomnia to test Mastercard APIs with a ready-made workflow for importing requests, configuring environments, and validating calls in Sandbox or Production.

For the full step-by-step guide, see the [Insomnia tutorial](https://developer.mastercard.com/platform/documentation/developer-tools/insomnia-collection/).

## Overview {#overview}

The Insomnia guide covers how to set up Mastercard API requests in Insomnia, including plugin installation, workspace import options, environment configuration, and request execution.

## Prerequisites {#prerequisites}

* Access to a Mastercard Developers project with the credentials required by the API you are testing
* Insomnia installed on your machine
* The correct authentication and encryption details for the service you want to call

## What You Will Find {#what-you-will-find}

* Plugin installation options for Insomnia
* Import guidance for collections and workspace templates
* Environment setup for OAuth 1.0a, OAuth 2.0, and JWE-enabled flows
* Practical steps for sending and validating requests in Sandbox and Production

## Insomnia Collections {#insomnia-collections}

|                    APIs                     |                                                                      Collection                                                                      |
|---------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
| Batch Credentials Enablement (Synchronous)  | [Batch_enroll_API.yaml](https://static.developer.mastercard.com/content/issuer-enrollment/uploads/Batch_enroll_API.yaml) (3KB)                       |
| Single Credential Enablement (Asynchronous) | [Single_enroll_API.yaml](https://static.developer.mastercard.com/content/issuer-enrollment/uploads/Single_enroll_API.yaml) (2KB)                     |
| Directory and Lifecycle Management          | [Lifecycle_management_API.yaml](https://static.developer.mastercard.com/content/issuer-enrollment/uploads/Lifecycle_management_API.yaml) (10KB)      |
| Mastercard Payment Passkey Creation         | [APIs for Issuer Passkeys.json](https://static.developer.mastercard.com/content/issuer-enrollment/uploads/APIs%20for%20Issuer%20Passkeys.json) (8KB) |

Warning: As of September 2026, the following Issuer Enrollment for Click to Pay APIs have been replaced with Mastercard's Credential Directory APIs. Use these collections for **existing integrations only**---for all new integrations use the above collections.

|        Legacy APIs        |                                                                      Collection                                                                       |
|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|
| Enroll API - Synchronous  | [Enroll API - Sync.json](https://static.developer.mastercard.com/content/issuer-enrollment/uploads/Enroll%20API%20-%20Sync.json) (32KB)               |
| Enroll API - Asynchronous | [Enroll API - Async.json](https://static.developer.mastercard.com/content/issuer-enrollment/uploads/Enroll%20API%20-%20Async.json) (47KB)             |
| Lifecycle Management APIs | [Lifecycle Management APIs.json](https://static.developer.mastercard.com/content/issuer-enrollment/uploads/Lifecycle%20Management%20APIs.json) (79KB) |

### Configure your environment {#configure-your-environment}

Our ready-to-use JSON or YAML packages contain the environment setup per collection. Replace the values for the following environment variables with your project level keys or IDs:

* consumerKey   
* keyAlias   
* keystoreP12Path   
* keystorePassword   
* srcClientId   

See a sample environment below.

![Environment setup in Insomnia](https://static.developer.mastercard.com/content/issuer-enrollment/documentation/img/insomnia-environment.png "Environment setup in Insomnia")