---
title: "Create a Sandbox Phone"
method: POST
path: "/phones/simulate/create_sandbox_phone"
tags: ["/phones"]
---

# Create a Sandbox Phone

`POST /phones/simulate/create_sandbox_phone`

Creates a new simulated phone in a [sandbox workspace](/core-concepts/workspaces#sandbox-workspaces). See also [Creating a Simulated Phone for a User Identity](/capability-guides/mobile-access/developing-in-a-sandbox-workspace#creating-a-simulated-phone-for-a-user-identity).

## Request body

- object
  - `assa_abloy_metadata` object — ASSA ABLOY metadata that you want to associate with the simulated phone.
    - `application_version` string — Application version that you want to use for the simulated phone.
    - `ble_capability` boolean — Indicates whether the simulated phone should have Bluetooth low energy (BLE) capability.
    - `hce_capability` boolean — Indicates whether the simulated phone should have host card emulation (HCE) capability.
    - `nfc_capability` boolean — Indicates whether the simulated phone should have near-field communication (NFC) capability.
    - `seos_applet_version` string — SEOS applet version that you want to use for the simulated phone.
    - `seos_tsm_endpoint_id` number, float — ID of the SEOS trusted service manager (TSM) endpoint that you want to use for the simulated phone.
  - `custom_sdk_installation_id` string — ID of the custom SDK installation that you want to use for the simulated phone.
  - `phone_metadata` object — Metadata that you want to associate with the simulated phone.
    - `device_manufacturer` string — Manufacturer that you want to use for the simulated phone.
    - `device_model` string — Device model that you want to use for the simulated phone.
    - `operating_system` 'android' | 'ios' — Mobile operating system that you want to use for the simulated phone.
    - `os_version` string — Mobile operating system version that you want to use for the simulated phone.
  - `user_identity_id` string, uuid, required — ID of the user identity that you want to associate with the simulated phone.

## Response `200`

OK

- object
  - `phone` Phone, required — Represents an app user's mobile phone. See the [phone object](/api/phones/object).
    - `created_at` string, date-time, required — Date and time at which the phone was created.
    - `custom_metadata` object, required — Optional [custom metadata](/core-concepts/devices/adding-custom-metadata-to-a-device) for the phone.
    - `device_id` string, uuid, required — ID of the phone.
    - `device_type` 'ios_phone' | 'android_phone', required — Type of the phone device, such as `ios_phone` or `android_phone`.
    - `display_name` string, required — Display name of the phone. Defaults to `nickname` (if it is set) or `properties.appearance.name`, otherwise. Enables administrators and users to identify the phone easily, especially when there are numerous phones.
    - `errors` object[], required — Errors associated with the phone.
      - `error_code` string, required — Unique identifier of the type of error.
      - `message` string, required — Detailed description of the error.
    - `nickname` string — Optional nickname to describe the phone, settable through Seam.
    - `properties` object, required — Properties of the phone.
      - `assa_abloy_credential_service_metadata` object — ASSA ABLOY Credential Service metadata for the phone.
        - `endpoints` object[] — Endpoints associated with the phone.
          - `endpoint_id` string — ID of the associated endpoint.
          - `is_active` boolean — Indicated whether the endpoint is active.
        - `has_active_endpoint` boolean — Indicates whether the credential service has active endpoints associated with the phone.
      - `salto_space_credential_service_metadata` object — Salto Space credential service metadata for the phone.
        - `has_active_phone` boolean — Indicates whether the credential service has an active associated phone.
    - `warnings` object[], required — Warnings associated with the phone.
      - `message` string, required — Detailed description of the warning.
      - `warning_code` string, required — Unique identifier of the type of warning.
    - `workspace_id` string, uuid, required — ID of the workspace that contains the phone.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)