Customers

The customer_portal Object

Represents a Customer Portal. Customer Portal is a hosted, customizable interface for managing device access. It enables you to embed secure, pre-authenticated access flows into your product—either by sharing a link with users or embedding a view in an iframe.

With Customer Portal, you no longer need to build out frontend experiences for physical access, thermostats, and sensors. Instead, you can ship enterprise-grade access control experiences in a fraction of the time, while maintaining your product's branding and user experience.

Seam hosts these flows, handling everything from account connection and device mapping to full-featured device control.

A customer portal resource.

{
  "created_at": "2025-06-16T16:54:17.946594Z",
  "customer_key": "My Company",
  "expires_at": "2025-06-17T16:54:17.946594Z",
  "url": "https://se.am/1234",
  "workspace_id": "67c58f1f-f148-4415-a63c-dc6c145c6b91"
}

Properties

created_at Datetime

Date and time at which the customer portal link was created.


customer_key String

Customer key for the customer portal.


expires_at Datetime

Date and time at which the customer portal link expires.


url String

URL for the customer portal.


workspace_id UUID

ID of the workspacearrow-up-right associated with the customer portal.


Endpoints

/customers/create_portal

Creates a new customer portal magic link with configurable features.

/customers/delete_data

Deletes customer data including resources like spaces, properties, rooms, users, etc. This will delete the partner resources and any related Seam resources (user identities, access grants, spaces).

/customers/push_data

Pushes customer data including resources like spaces, properties, rooms, users, etc.

Last updated

Was this helpful?