---
title: "Create a ABM provisioning request using device serial number"
method: POST
path: "/v2/seamless"
tags: ["device_onboarding_ABM Provisioning"]
---

# Create a ABM provisioning request using device serial number

`POST /v2/seamless`

⚠️ Apple devices only. 

Creates an ABM provisioning request for a single device using its serial number supplied in a JSON request body, pre-assigning it to a blueprint and optionally a group, alias, and tags.

**About Create ABM Provisioning Request (Serial Number)**

This endpoint is the JSON-body alternative to the CSV upload path for seamless ABM provisioning. It accepts a SeamlessRequestBody containing the assigned_blueprint_id, an optional group_id, an optional alias, an optional tags array, and a seamless_info object with unique_ids (a single device identifier) and unique_id_type. This endpoint provisions exactly one device per request; for bulk provisioning of multiple devices, use POST /api/v2/seamless/upload. On success it returns a single SeamlessRequest record. This is the preferred method for programmatic or API-driven provisioning workflows where a device identifier is available at runtime rather than in a pre-prepared file.

**Key Fields**

assigned_blueprint_id (body, required) — UUID of the blueprint to assign to the device

group_id (body, optional) — UUID of the group to assign the device to

alias (body, optional) — Human-readable alias to assign to the device; omitting this field never clears an existing device alias

tags (body, optional) — Array of tag names to assign to the device (maximum 5); tag names are resolved to (or created as) tags for the tenant asynchronously

seamless_info.unique_ids (body) — A single device identifier (e.g., a serial number)

seamless_info.unique_id_type (body) — Integer type code identifying the identifier format

id (response) — SeamlessRequest UUID

assigned_blueprint_id (response) — Confirmed blueprint assignment

group_id (response) — Confirmed group assignment (nullable)

alias (response) — Confirmed alias assignment (nullable)

tags (response) — Confirmed tag names assignment (nullable)

**Common Use Cases**

Programmatically pre-assigning a specific device to a blueprint as part of an automated provisioning pipeline

Registering a known device serial number for zero-touch enrollment without preparing a CSV file

Integrating ABM provisioning into a device lifecycle management workflow driven by an external system

**Best Practices**

Ensure assigned_blueprint_id references a published blueprint version — assigning an unpublished blueprint will result in a device that cannot complete hands-free enrollment

This endpoint accepts exactly one device identifier per request; a comma-separated or otherwise multi-value unique_ids is rejected with a 400 — use POST /api/v2/seamless/upload with a CSV to provision multiple devices in a single call

For large-scale bulk provisioning, POST /api/v2/seamless/upload with a CSV may be more practical

## Request body

- DeviceOnboardingSeamlessRequestBody
  - `assigned_blueprint_id` string, uuid
  - `group_id` string, uuid
  - `alias` string, nullable
  - `tags` string[], nullable
  - `seamless_info` DeviceOnboardingSeamlessInfo
    - `unique_ids` string
    - `unique_id_type` integer

## Response `200`

Seamless request successfully created.

- object
  - `code` integer
  - `message` string
  - `content` DeviceOnboardingSeamlessRequest
    - `id` string, uuid
    - `assigned_blueprint_id` string, uuid
    - `group_id` string, uuid, nullable
    - `alias` string, nullable
    - `tags` string[], nullable
    - `unique_ids` string
    - `unique_id_type` integer
    - `tenant_id` string

## Other responses

- `400` — Bad request
- `401` — Authorization information is missing or invalid.
- `500` — Internal server error

## Changes

- **2026-09-03** `6b55f43485ae` — 4 info
  - added the new optional request property `alias`
  - added the new optional request property `tags`
  - added the optional property `content/alias` to the response with the `200` status
  - added the optional property `content/tags` to the response with the `200` status

[Change history](https://skmtc.dev/esper/apis/esper-api-reference/changes/v2/seamless/post.md)

---

[API](https://skmtc.dev/esper/apis/esper-api-reference.md) · [All operations](https://skmtc.dev/esper/apis/esper-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/esper/esper-api-reference/revisions/6b55f43485ae/schema)