Workspaces

Create a workspace

Creates a workspace from a company profile, owned by the calling account, with its own team and billing. It becomes the default workspace only when the account had none.

POST
/workspaces

Authorizations

Authorizationstringheaderrequired

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

Body

application/json
namestringrequired

Company name, 1 to 120 characters.

sellsstringrequired

What the company sells, in one line of up to 500 characters.

problemsstring[]required

Problems the company solves for its customers. Each is up to 120 characters; messages draw on them.

Maximum array length: 20

customersstring[]required

Names of current customers, each up to 120 characters. Leads whose company has one of these names are skipped.

Maximum array length: 200

domainstring | nullrequired

Company website domain, like yourcompany.com, without https:// or a path; null when there is none.

timezonestring

IANA time zone of the outreach schedule, like Europe/Rome. Leave it out to keep the current one; a new workspace starts on UTC.

Response

application/json

Success

workspaceobjectrequired
roleenum<string>required

The account's role here: owner (one per workspace, the only one who can transfer ownership), admin (can change the profile, setup, team and billing) or member (works in the workspace without those rights).

Available options: owner, admin, member

defaultbooleanrequired

True when calls without a bavlio-workspace header act in this workspace.

email_noticesobjectrequired

Which email notices the member receives, true for on: reply_needs_answer when a lead's reply needs an answer, meeting_booked and meeting_canceled when a meeting is booked or canceled, trial_ending a few days before the workspace's trial ends (sent to the owner and admins only). New members start with only trial_ending on.