Skip to content
Last updated

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.