---
title: "Bootstrap Onboarding"
method: POST
path: "/api/organization/onboarding/bootstrap"
tags: ["organization"]
---

# Bootstrap Onboarding

`POST /api/organization/onboarding/bootstrap`

Bootstrap a new organization during onboarding.

This endpoint sets up the structural defaults a new org needs:
- Default prospecting pipeline stages + settings
- Default org skill templates
- Subdomain slug + (unpublished) booking page
- Daily Brief scheduled task
- Optional Google Contacts import only when enabled in code
- Welcome email

No sample client/service/skill is seeded — the welcome agent creates
vertical-appropriate examples on demand.

The endpoint is idempotent and safe to call multiple times.

## Request body

- OnboardingBootstrapRequest — Request model for onboarding bootstrap
  - `timezone` string, nullable — IANA timezone from browser (e.g., 'America/New_York'). Obtained via Intl.DateTimeFormat().resolvedOptions().timeZone
  - `daily_brief` object, nullable — Optional Daily Brief defaults to apply during bootstrap

## Response `200`

Successful Response

- OnboardingBootstrapResponse — Response model for onboarding bootstrap
  - `already_seeded` boolean, required
  - `subdomain_slug` string, nullable
  - `subdomain_created` boolean
  - `welcome_sent` boolean
  - `marked_complete` boolean
  - `user_email` string, nullable
  - `timezone_set` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/9744001af85d/schema)