# JumpCloud

JumpCloud is a cloud-based directory platform that provides secure identity, access, and device management solutions for organizations.

- **Category:** security & identity tools
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 2
- **Triggers:** 0
- **Slug:** `JUMPCLOUD`
- **Version:** 20260227_00

## Tools

### Create System

**Slug:** `JUMPCLOUD_CREATE_SYSTEM`

Validates credentials and provides guidance for enrolling systems in JumpCloud. Important: JumpCloud does not support creating systems via REST API. Systems must be enrolled by installing the JumpCloud Agent on each device. This action performs a credential validation check and returns detailed instructions for agent-based system enrollment, including documentation links and Connect key guidance. Use this action when you need to: - Understand how to enroll new systems in JumpCloud - Validate API credentials before system management operations - Get documentation links for the JumpCloud Agent installation process

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x-org-id` | string | No | Organization ID for multi-tenant admin accounts. Only required if managing multiple organizations. Sends as 'x-org-id' header to scope the request to a specific organization. |
| `message_template` | string | No | Custom text to append to the enrollment guidance message. Use this to add organization-specific instructions or contact information. Supports unicode characters and emojis. |
| `preflight_resource` | string | No | JumpCloud resource type to query for credential validation. Use 'systems' for v1 API validation or 'systemgroups' for v2 API validation. Defaults to 'systems' if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Role

**Slug:** `JUMPCLOUD_DELETE_ROLE`

Deletes a specific custom role from JumpCloud by its ID. This action permanently removes a custom role. Built-in system roles (Administrator, Read Only, Manager, etc.) cannot be deleted. Before deleting a role, ensure it is not currently assigned to any administrators. The operation is idempotent - attempting to delete a non-existent role returns success (404 treated as successful deletion).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role_id` | string | Yes | The unique identifier (UUID) of the role to delete. Only custom roles can be deleted; built-in system roles cannot be removed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |