# Using "Try it"

The **Try it** feature lets you send real requests to the M2X Public API straight from the reference docs and see live responses. Endpoints are secured, so you'll first authenticate by requesting an access token, then send your request.

## 1. Start a request

1. On the endpoint you want to call, click **Try it**.
2. Open the **Environments** menu in the top-right corner of the page.
3. Select the environment you want to use.


No suitable environment?
If the environment you need isn't in the list, create a new one from the same **Environments** menu.

## 2. Request an access token

Authentication uses the OAuth client credentials flow. To get a token:

1. Go to the **Security** tab.
2. Expand the **Configure new token** panel.
3. Set your **Client ID** — hover over the Client ID input field, click **Set value**, then enter your client ID.
4. Set your **Client secret** the same way.
5. Leave the **Access token** field blank.
6. Optionally adjust the **scopes** for the token (see below).
7. Scroll down and click **Request new token**.


Why leave the access token blank?
The Access token field is populated automatically once the token request succeeds — you don't need to fill it in yourself.

### Token scopes

By default, a new token is issued with **all scopes enabled**, so it can access everything your credentials allow. You can toggle individual scopes on and off before requesting the token to narrow what it's permitted to do.

For example, switching off the write scopes leaves a token with **read-only** access — handy when you just want to inspect data without any risk of changing it.

## 3. Send your request

With a valid token in place, fill in any required parameters and send the request. Responses appear inline so you can inspect the status code, headers, and body.

Keep your credentials safe
Your Client ID and secret authenticate as your account. Use credentials scoped to a test environment where possible, and never share them.