---
title: "Post Create Workspace"
method: POST
path: "/api/workspaces"
tags: ["auth"]
---

# Post Create Workspace

`POST /api/workspaces`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/workspaces`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- CreateWorkspaceRequest
  - `domain` string, nullable: Optional company domain used by workspace onboarding.
  - `name` string, required: Display name of the workspace to create.
  - `onboardingProfile` OnboardingProfilePayload: Workspace onboarding facts and optional employee-directory setup.
    - `company_domain` string: Company domain for the onboarding profile and employee sync; workspace creation falls back to its domain argument when blank.
    - `company_name` string: Company display name; workspace creation uses the workspace name when blank.
    - `employee_count` string: Company headcount or size-range label retained as text in the onboarding profile.
    - `full_name` string: Viewer full name to save in onboarding and the viewer profile; blank leaves the viewer name unchanged.
    - `industry` string: Company industry retained as free text in the onboarding profile; this field is not a search-filter industry enum.
    - `linkedin_url` string: Company LinkedIn page URL. Employee-directory sync requires a nonblank URL and company domain.
    - `logo_url` string: Company logo URL; a nonblank URL may be fetched and copied into customer asset storage during onboarding.
    - `sync_departments` string[]: Departments to target during employee sync. Empty selects sales and recruiting in workspace onboarding. Dedicated title searches support sales, recruiting, and engineering; other strings have no dedicated title expansion. Founders and executives are included across departments.
    - `sync_employee_directory` boolean: Request an employee-directory workflow that creates pending LinkedIn sender identities; requires company domain and LinkedIn URL. False leaves sync disabled.
    - `use_case` string: Description of the intended product use, retained in the onboarding profile.

## Response `200`

Successful Response

- CreateWorkspaceResponse
  - `ok` true, required
  - `orgId` string, required
  - `personalizationWorkflowId` string, nullable, required
  - `slug` string, required
  - `starterTemplateIds` StarterTemplateIdsPayload, required
    - `emailLinkedinCsv` string, nullable, required
    - `emailOnly` string, nullable, required
    - `linkedinOnly` string, nullable, required
  - `syncEmployeesWorkflowId` string, nullable, required
  - `viewerSenderId` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)