Skip to main content

Commands

Provision a number

Standard provisioning requires a completed LLC formation and the company EIN (for carrier registration). Sole proprietors can pass --sole-prop instead: no LLC/EIN needed, just a passed KYC verification — the brand is registered against the verified individual and Surge texts an SMS OTP to their verified mobile (lower carrier throughput than EIN-registered brands). Returns the new number (live for inbound SMS immediately) and the carrier campaign status. Outbound SMS unlocks automatically when the campaign is approved.

Resend the brand-verification OTP

Re-sends the sole-proprietor brand-verification SMS OTP if it expired or never arrived. Sole-prop accounts only.

Check status

Shows the Surge account, the 10DLC campaign status, and per-number capabilities — use it to see whether outbound SMS is unlocked.

Send an SMS

Returns compliance_pending (no charge) if the campaign isn’t approved yet. Sending is not approval-gated.

Read received SMS

Agent assignment

Release a number

Releases the number back to the provider, removes agent connections, and stops monthly rental billing. Permanent.

Governance

Provisioning a number is sensitive (it spends credits and registers a carrier campaign). Depending on the user’s Account Kit it may require human approval — the command then returns status: "pending_approval" and runs only after naive approvals approve <id>. Sending SMS is not approval-gated. See naive approvals --help.