POST
/
workspaces
curl --request POST \
  --url https://api.dock.so:4000/{version}/workspaces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "templateId": "1234567890",
  "hubspotCompanyId": "1234567890",
  "hubspotDealId": "1234567890",
  "salesforceAccountId": "1234567890",
  "salesforceOpportunityId": "1234567890",
  "accountId": "1234567890",
  "shareSetting": "landingPage",
  "notifyPeople": false,
  "workspaceUsers": [
    {
      "email": "jsmith@example.com",
      "role": "owner"
    }
  ],
  "workspaceDomains": [
    {
      "domain": "<string>",
      "role": "owner"
    }
  ],
  "name": "My Workspace",
  "autoPublishWorkspace": false,
  "googleVerificationEnabled": false,
  "magicLinkVerificationEnabled": false,
  "welcomePageCta": "View Workspace",
  "welcomePageText": "<string>"
}'
{
  "data": {
    "workspace": {
      "id": "RiHO4e0Ju3DS",
      "updatedAt": "2021-01-01T00:00:00.000Z",
      "createdAt": "2021-01-01T00:00:00.000Z",
      "workspaceUsers": [
        {
          "id": "RiHO4e0Ju3DS",
          "updatedAt": "2021-01-01T00:00:00.000Z",
          "createdAt": "2021-01-01T00:00:00.000Z",
          "role": "owner",
          "user": {
            "id": "RiHO4e0Ju3DS",
            "updatedAt": "2021-01-01T00:00:00.000Z",
            "createdAt": "2021-01-01T00:00:00.000Z",
            "object": "user",
            "url": "https://api.dock.us/v1/users/RiHO4e0Ju3DS",
            "firstName": "John",
            "lastName": "Doe",
            "avatar": "https://dock.us/avatar.png",
            "email": "john.doe@example.com",
            "name": "John Doe"
          }
        }
      ],
      "workspaceDomains": [
        {
          "id": "RiHO4e0Ju3DS",
          "updatedAt": "2021-01-01T00:00:00.000Z",
          "createdAt": "2021-01-01T00:00:00.000Z",
          "role": "owner",
          "domain": "dock.us"
        }
      ],
      "account": {
        "id": "RiHO4e0Ju3DS",
        "updatedAt": "2021-01-01T00:00:00.000Z",
        "createdAt": "2021-01-01T00:00:00.000Z",
        "object": "account",
        "url": "https://api.dock.us/v1/accounts/RiHO4e0Ju3DS",
        "name": "Dock",
        "website": "https://dock.us",
        "ownerId": "RiHO4e0Ju3DS",
        "logo": "https://dock.us/logo.png",
        "salesforceAccountId": "0015f00000Bg59dAAB",
        "hubspotCompanyId": "8662045446"
      },
      "object": "workspace",
      "url": "https://api.dock.us/v1/workspaces/RiHO4e0Ju3DS",
      "name": "Customer Onboarding",
      "workspaceUrl": "https://acme.dock.us/customer-onboarding-vRQgIvscHAiO",
      "templateId": "RiHO4e0Ju3DS",
      "startDate": "2024-01-01",
      "targetEndDate": "2024-01-01",
      "actualEndDate": "2024-01-01",
      "projectAge": 100,
      "taskProgress": "50",
      "lastContactView": "2024-01-01T00:00:00Z",
      "totalViews": 100,
      "totalActions": 100,
      "totalTimeSpent": 100,
      "contactsCount": 100,
      "deal": {
        "id": "RiHO4e0Ju3DS",
        "updatedAt": "2021-01-01T00:00:00.000Z",
        "createdAt": "2021-01-01T00:00:00.000Z",
        "hubspotDealId": "1234567890",
        "object": "deal",
        "url": "https://api.dock.us/v1/deals/RiHO4e0Ju3DS",
        "createdDate": "2024-01-01T00:00:00Z",
        "closeDate": "2024-01-01T00:00:00Z",
        "name": "Deal 1",
        "amount": "100000",
        "type": "New Business",
        "stage": "Proposal Sent"
      },
      "customFields": [
        {
          "id": "RiHO4e0Ju3DS",
          "updatedAt": "2021-01-01T00:00:00.000Z",
          "createdAt": "2021-01-01T00:00:00.000Z",
          "object": "customField",
          "url": "https://api.dock.us/v1/custom-fields/RiHO4e0Ju3DS",
          "variableName": "account.name",
          "type": "singleCheckbox",
          "options": [
            {
              "index": 1,
              "label": "Yes",
              "value": "true"
            }
          ],
          "value": "Yes"
        }
      ]
    }
  }
}

Authorizations

Authorization
string
header
required

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

Query Parameters

properties
enum<string>[]

Select the workspace properties that should be returned

Available options:
accountId,
name,
workspaceUrl,
templateId,
startDate,
targetEndDate,
actualEndDate,
projectAge,
taskProgress,
lastContactView,
totalViews,
totalActions,
totalTimeSpent,
contactsCount,
account.name,
account.website,
account.ownerId,
account.logo,
account.salesforceAccountId,
account.hubspotCompanyId,
account.createdAt,
account.updatedAt,
customFields.name,
customFields.type,
customFields.variableName,
customFields.value,
workspaceDomains.domain,
workspaceDomains.role,
workspaceDomains.createdAt,
workspaceDomains.updatedAt,
workspaceUsers.role,
workspaceUsers.createdAt,
workspaceUsers.updatedAt,
workspaceUsers.user.firstName,
workspaceUsers.user.lastName,
workspaceUsers.user.avatar,
workspaceUsers.user.email,
workspaceUsers.user.name,
workspaceUsers.user.createdAt,
workspaceUsers.user.updatedAt,
deal.name,
deal.amount,
deal.closeDate,
deal.createdDate,
deal.type,
deal.stage,
deal.hubspotDealId,
deal.salesforceOpportunityId

Body

application/json
templateId
string

ID of the template to use for the workspace

Example:

"1234567890"

hubspotCompanyId
string

ID of the HubSpot company to use for the workspace

Example:

"1234567890"

hubspotDealId
string

ID of the HubSpot deal to use for the workspace

Example:

"1234567890"

salesforceAccountId
string

ID of the Salesforce account to use for the workspace

Example:

"1234567890"

salesforceOpportunityId
string

ID of the Salesforce opportunity to use for the workspace

Example:

"1234567890"

accountId
string

ID of the account to use for the workspace

Example:

"1234567890"

shareSetting
enum<string>

Share setting for the workspace

Available options:
landingPage,
withLink,
restricted
Example:

"landingPage"

notifyPeople
boolean
default:false

Notify people for the workspace

workspaceUsers
object[]

Users to access the workspace

workspaceDomains
object[]

Domains to access the workspace

name
string

Name of the workspace

Example:

"My Workspace"

autoPublishWorkspace
boolean
default:false

Auto publish workspace

googleVerificationEnabled
boolean
default:false

Google verification enabled

Magic link verification enabled

welcomePageCta
string
default:View Workspace

Welcome page CTA

welcomePageText
string

Welcome page text

Response

200
application/json
Workspace created
data
object