# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.whereby.com/further-resources/using-postman.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.