# Add Autopilot Device

### Description

This runbook imports a Windows device into Windows Autopilot using the device serial number and hardware hash. It can optionally wait for the import job to finish and supports tagging during import.

### Location

Organization → Devices → Add Autopilot Device

**Full Runbook name**

rjgit-org\_devices\_add-autopilot-device

### Permissions

#### Application permissions

* **Type**: Microsoft Graph
  * DeviceManagementServiceConfig.ReadWrite.All

### Parameters

#### SerialNumber

Device serial number as returned by Get-WindowsAutopilotInfo.

| Property      | Value  |
| ------------- | ------ |
| Required      | true   |
| Default Value |        |
| Type          | String |

#### HardwareIdentifier

Device hardware hash as returned by Get-WindowsAutopilotInfo.

| Property      | Value  |
| ------------- | ------ |
| Required      | true   |
| Default Value |        |
| Type          | String |

#### AssignedUser

Optional user to assign to the Autopilot device.

| Property      | Value  |
| ------------- | ------ |
| Required      | false  |
| Default Value |        |
| Type          | String |

#### Wait

If set to true, the runbook waits until the import job completes.

| Property      | Value   |
| ------------- | ------- |
| Required      | false   |
| Default Value | True    |
| Type          | Boolean |

#### GroupTag

Optional group tag to apply to the imported device.

| Property      | Value  |
| ------------- | ------ |
| Required      | false  |
| Default Value |        |
| Type          | String |

[Back to Runbook Reference overview](/automation/runbooks/runbook-references.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.realmjoin.com/automation/runbooks/runbook-references/org/devices/add-autopilot-device.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
