Skip to main content
POST
/
workspaces
/
create
await seam.workspaces.create({
  name: "My Sandbox Workspace",
  company_name: "Acme",
  connect_partner_name: "Acme",
  is_sandbox: true,
  is_publishable_key_auth_enabled: true,
  publishable_key: "seam_pk1fGd41X_zKs0ZELRTEc8nWxiBsEXAMPLE",
  webview_primary_button_color: "#232426",
  webview_primary_button_text_color: "#FFFDE7",
  webview_logo_shape: "circle",
  webview_success_message:
    "Your account has been successfully connected to Acme!",
  connect_webview_customization: {
    inviter_logo_url:
      "https://connect.getseam.com/internal/images/view?image_id=1de135fa-f0c2-4e57-90d0-6b9a7d090a0c",
    logo_shape: "circle",
    primary_button_color: "#232426",
    primary_button_text_color: "#FFFDE7",
    success_message: "Your account has been successfully connected to Acme!",
  },
});

/*
{
  "company_name": "Acme",
  "connect_partner_name": "Acme",
  "connect_webview_customization": {
    "inviter_logo_url": "https://connect.getseam.com/internal/images/view?image_id=1de135fa-f0c2-4e57-90d0-6b9a7d090a0c",
    "logo_shape": "circle",
    "primary_button_color": "#232426",
    "primary_button_text_color": "#FFFDE7",
    "success_message": "Your account has been successfully connected to Acme!"
  },
  "is_sandbox": true,
  "is_publishable_key_auth_enabled": true,
  "publishable_key": "seam_pk1fGd41X_zKs0ZELRTEc8nWxiBsEXAMPLE",
  "is_suspended": false,
  "name": "My Sandbox Workspace",
  "workspace_id": "6a0b6282-6a98-4fef-811e-0904c485ac7a"
}
*/
{
  "ok": true,
  "workspace": {
    "company_name": "<string>",
    "connect_partner_name": "<string>",
    "connect_webview_customization": {
      "inviter_logo_url": "<string>",
      "primary_button_color": "<string>",
      "primary_button_text_color": "<string>",
      "success_message": "<string>"
    },
    "is_publishable_key_auth_enabled": true,
    "is_sandbox": true,
    "is_suspended": true,
    "name": "<string>",
    "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "publishable_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 new workspace.

​
company_name
string

Company name for the new workspace.

​
connect_partner_name
string | null
deprecated

Connect partner name for the new workspace.

​
connect_webview_customization
object

Connect Webview customizations for the new workspace. See also Customize the Look and Feel of Your Connect Webviews.

​
is_sandbox
boolean
default:false

Indicates whether the new workspace is a sandbox workspace.

​
organization_id
string<uuid>

ID of the organization to associate with the new workspace.

​
webview_logo_shape
enum<string>
deprecated
Available options:
circle,
square
​
webview_primary_button_color
string
deprecated
​
webview_primary_button_text_color
string
deprecated
​
webview_success_message
string
deprecated

Response

OK

​
ok
boolean
required
​
workspace
object
required

Represents a Seam workspace. A workspace is a top-level entity that encompasses all other resources below it, such as devices, connected accounts, and Connect Webviews. Seam provides two types of workspaces. A sandbox workspace is a special type of workspace designed for testing code.