USusebubbles

Join a listed existing workspace (action:"join", team_id) or create a new one (action:"create", workspace_name) — the same createTeamSnapshot / self-invite path the web flow uses. A team_id that is not joinable by the verified email domain is refused with 403 forbidden. On create, the response also carries the new workspace's free Pro-trial status with its benefits (pro_trial) and, when the verified email is a non-public company domain, a domain_join offer; the agent may then call action:"enable_domain_join" to let anyone with that verified email domain auto-join the workspace (only the user's own verified non-public company domain is ever accepted — never a public or consumer email domain). Returns the resulting team_id and advances to the calendar step.

post/v1/signup/workspace

Request

  • Base URL
    https://api.usebubbles.com
  • Auth
    none required

Request body

signup_sessionstring required

A verified signup token.

action'join' | 'create' | 'enable_domain_join' required

Join an existing workspace, create a new one, or (after creating, for a non-public verified domain the response offered) allow anyone with that verified email domain to auto-join.

team_idstring

For action:"join" — a listed, domain-matched workspace id.

workspace_namestring

For action:"create" — the new workspace name.

Response

Success.

next_step'calendar' required

The next call to make.

team_idstring

The workspace the user joined or created.

domain_join_enabledboolean

True on an action:"enable_domain_join" response — the domain is now open for auto-join.

domainstring

The domain opened for auto-join (enable_domain_join response).

agent_contextstring required

Agent-facing guidance for this step: what happened, what to tell the user, and what to ask/call next.

relay_to_userstring required

Plain-language text for the agent to show the user.

signup_sessionstring required

Opaque token advanced to the calendar step.

Changes

No recorded changes to this operation across all 1 revision of this API.