Begin an agent-driven signup: submit an email, and Bubbles emails a verification code. The response is identical whether or not an account already exists (it never reveals whether the email is registered before the code is verified — the unified flow logs in existing users and signs up new ones). Returns a signup_session to pass to the next steps and relay_to_user text to show the user. Call again to resend. A malformed/disallowed/temporary email is rejected with 400 invalid_request. Per-IP throttled.

post/v1/signup/start

Request

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

Request body

emailstring required

The work email to sign up / send the verification code to.

Response

Success.

next_step'verify' required

The next call to make.

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 to pass to the next step.

Changes

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