Overview

To authenticate with Datto RMM, you need:
  1. Platform – Your Datto RMM platform (e.g., merlot, pinotage, concord, vidal, zinfandel, syrah). This determines your API base URL like https://<platform>-api.centrastage.net.
This guide walks you through enabling API access and finding your Platform (Region) in Datto RMM.

Prerequisites:

  • Admin access to your Datto RMM tenant.

Step 1: Enable API access and generate API keys

  1. Login to your Datto RMM instance, go to Setup > Global Settings > Access Control and toggle the Enable API Access button.
  1. Go to Setup > Users, select your user, then click Generate API Keys to create an API Key and API Secret Key for the user.
  1. The API Key and API Secret Key will be displayed. You will need to use these keys to fill out the login form: enter the API Key in the Access Key field and the API Secret Key in the Secret Key field.
  1. Click Save User.

Step 2: Select your platform

Your platform corresponds to your region and defines your base URL:
  • merlothttps://merlot-api.centrastage.net
  • pinotagehttps://pinotage-api.centrastage.net
  • concordhttps://concord-api.centrastage.net
  • vidalhttps://vidal-api.centrastage.net
  • zinfandelhttps://zinfandel-api.centrastage.net
  • syrahhttps://syrah-api.centrastage.net
You can also verify Swagger at https://<platform>-api.centrastage.net/api/swagger-ui/index.html.

Step 3: Enter your details in the Connect UI

Once you have the Platform:
  1. Open the form where you need to authenticate with Datto RMM.
  2. Enter the Platform (e.g., merlot) in the appropriate field.
  3. Submit the form to proceed to the OAuth consent, complete the authorization, and you should be successfully authenticated.
You are now connected to Datto RMM.