Skip to main content
POST
/
spaces
/
create
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"
}
*/
{
  "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

​
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.

​
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

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.