# Postman collection

{% embed url="<https://youtu.be/9zDEvN0BZ4E>" %}

{% hint style="info" %}
**Note**: To use the API, you’ll need to [create an API key](https://docs.whereby.com/getting-started/overview-of-whereby-embedded/initial-setup#id-2.-generate-an-api-key). A new key is generated from the “Configure” section in the Embedded dashboard. Your API key is secret and should only be used from your server.
{% endhint %}

Postman is an API platform for building and using APIs. You can use Postman to interact with the Whereby REST API. If you don’t have a Postman account already, sign up for one here: <https://www.postman.com/>

Next, open [Whereby’s Embedded API Postman collection](https://www.postman.com/wherebyhq/workspace/whereby-s-public-workspace/collection/15283449-36906103-00b9-43fa-88e4-f2ed52fdedd3?ctx=documentation)

Start by creating your own copy of the collection by clicking the “Fork” button and add the copy to your own Postman workspace

![](https://content.gitbook.com/content/LH2UIJDLc2EElQvYUxWX/blobs/iDlq3pPYDms3ihtN5V77/postman%201.png)

In your forked collection, paste your API token into the "Token" field, and then click "Save".

![](https://content.gitbook.com/content/LH2UIJDLc2EElQvYUxWX/blobs/BpBqvbB6S9ICC19lVtqi/postman%202.png)

Now you're ready to create a room.&#x20;

1. Click one of the "Create room" requests in the left column
2. Click "Send"
3. You should receive a response containing meeting information and URL

![](https://content.gitbook.com/content/LH2UIJDLc2EElQvYUxWX/blobs/LshzybQ3Kj8f2dQdE2xW/postman%203.png)

4. Copy the room URL from the response and open it in your browser.

Congratulations! You have created a Whereby meeting room!

{% hint style="info" %}
**Note**: If you want to test a room as a guest/visitor, it can be a good idea to open meeting rooms in a private window to make sure you aren't accidentally logged into your subdomain! Being logged into your Whereby account will give you host privileges in rooms under the corresponding subdomain.
{% endhint %}