# M2M users

### Overview

M2M (Machine-to-Machine) users enable secure API integrations between Dataloy VMS and external systems. These automated users authenticate using client credentials rather than traditional username/password combinations, allowing systems to communicate without human intervention.

### Access Requirements

To create and manage M2M users, you need one of the following roles:

* **Administrator**
* **M2MProvisioning**

### Creating an M2M User

#### Step 1: Navigate to M2M Users

From the main menu, go to **Setup** → **M2M users**

The M2M users page displays all existing machine users with their names and Client IDs.

#### Step 2: Create New User

Click the **"+"** button in the top right corner to open the creation dialog.

Insert a username and necessary security groups.

<figure><img src="https://content.gitbook.com/content/uZ9lzqgHX4JL1Df67xog/blobs/6eVgwPldoX7jluoaGJD0/Screenshot%202025-09-03%20at%2010.23.27.png" alt=""><figcaption></figcaption></figure>

Click **Confirm** to create the user.

### Managing M2M Users

#### Viewing User Details

Click on any M2M user from the list to view and manage its configuration:

<figure><img src="https://content.gitbook.com/content/uZ9lzqgHX4JL1Df67xog/blobs/6wYAL6P3mtJrbf8dxPIA/Screenshot%202025-09-03%20at%2010.23.45.png" alt=""><figcaption></figcaption></figure>

The detail view shows:

* **M2M Name**: The integration identifier
* **Client ID**: The unique identifier used for authentication
* **Client Secret**: The secure token (masked by default)
* **Security Groups**: Current permission assignments
* **Business Units**: Assigned business units

#### Sharing Credentials

Provide the following to your integration partner:

1. **Client ID**
2. **Client Secret**
3. Link to authentication documentation: [Authentication & Authorization](https://app.gitbook.com/o/-LhoT2vqihl0pYiCeolt/s/wrvQUTAwc00ji4moOvmW/dataloy-rest-api/authentication-authorization)

### Related Documentation

* [Authentication & Authorization](https://app.gitbook.com/o/-LhoT2vqihl0pYiCeolt/s/wrvQUTAwc00ji4moOvmW/dataloy-rest-api/authentication-authorization) - Technical implementation details for API authentication
* [Data Control](https://app.gitbook.com/o/-LhoT2vqihl0pYiCeolt/s/yYbNukLL3zJksOADeOR7/voyage-management-system/step-by-step-guides/setup/data-control) - Managing business unit access restrictions