Create a Space

Creates a new space.

POST /spaces/create

JavaScript

Seam SDK

await seam.spaces.create({ name: "My Space", device_ids: ["b7254403-db91-4e10-bb7b-31d0615d2963"], acs_entrance_ids: ["46a47667-a90b-45cc-9bb6-f0917464f1f3"], }); /* { "created_at": "2025-06-16T16:54:17.946600Z", "display_name": "My Space", "name": "My Space", "space_id": "5afeb047-3277-4102-b8c4-99edf05b91d2", "workspace_id": "96bd12f9-6def-4bf4-b517-760417451ae9" } */

200

{
  "ok": true,
  "space": {
    "acs_entrance_count": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "device_count": 123,
    "display_name": "<string>",
    "name": "<string>",
    "space_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "customer_data": {
      "default_checkin_time": "<string>",
      "default_checkout_time": "<string>",
      "time_zone": "<string>"
    },
    "customer_key": "<string>",
    "parent_space_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "parent_space_key": "<string>",
    "space_key": "<string>"
  }
}

Authorizations

pat_with_workspaceconsole_session_with_workspaceapi_keyclient_session_with_customer

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

Name of the space that you want to create.

acs_entrance_ids · string<uuid>[]

IDs of the entrances that you want to add to the new space.

connected_account_ids · string<uuid>[]

IDs of connected accounts to associate with the new space. Persisted on seam.location_third_party_account so the UI can show which provider account(s) a space came from.

customer_data · object

Reservation/stay-related defaults for the space.

Show child attributes

customer_key · string

Customer key for which you want to create the space.

Minimum string length: 1

device_ids · string<uuid>[]

IDs of the devices that you want to add to the new space.

space_key · string

Unique key for the space within the workspace.

Response

200

application/json

OK

ok · boolean · required

space · object · required

Represents a space that is a logical grouping of devices and entrances. You can assign access to an entire space, thereby making granting access more efficient.

Show child attributes