> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapso.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instant setup

> Use Kapso-managed pre-verified numbers for the default fast onboarding flow.

## What it is

Instant setup is the default Kapso-managed phone number path for WhatsApp onboarding.

Kapso provisions the number and, when available, uses a pre-verified number so the customer can finish onboarding without manual SMS or phone-call verification.

## What it enables

* Fast onboarding with Kapso-managed numbers
* No Twilio account required
* No custom telephony setup required
* Pre-verified number assignment when capacity is available

## Availability

* Default country: `US`
* Number ownership: Kapso-managed
* Best for: standard onboarding when you do not need local numbers or your own Twilio account

If you need local numbers, your own Twilio billing, or reusable project-owned inventory, use [Bring your own Twilio](/docs/platform/phone-numbers/bring-your-own-twilio).

## Free number for new users

Free plan users get one Kapso-managed number at no cost — no wallet deposit required.

Eligibility:

* Free plan only
* The user's default first project
* One lifetime claim per user
* Kapso instant setup path only

If that first free number is later deleted or disconnected, the lifetime free claim does **not** reset. A replacement Kapso-managed number may require the standard deposit, which goes directly to project credits.

If the number has no production messages within 30 days, it is automatically released.

## How pre-verified numbers work

Kapso keeps a shared pool of pre-verified numbers for the default instant-setup path.

When a ready number is available for the requested country, Kapso can pass that number into the onboarding flow and skip the normal OTP verification step.

When no ready pre-verified number is available, onboarding still works. Kapso falls back to the standard provisioning path.

## Embedded signup behavior

For the default instant-setup path, Kapso tries:

1. A ready pre-verified number from the shared pool
2. Standard provisioning if no ready pre-verified number is available

This means instant setup is opportunistically pre-verified, not a hard requirement.

## Setup links behavior

Setup links use the same default logic.

If `provision_phone_number` is enabled and the request is for a supported default country, Kapso will try the shared pre-verified pool first. If no ready number exists, the setup link still works and falls back to standard provisioning.

## Limits

Instant setup is not the right fit when you need:

* non-US local numbers
* your own Twilio account
* project-owned reusable number pools
* country-by-country number inventory control

For those cases, use [Bring your own Twilio](/docs/platform/phone-numbers/bring-your-own-twilio).