Skip to main content
Beta is a preview. The Beta (2.0) platform does not have all the features of Stable yet. For example, iMessage on Beta supports only text and images, so tapbacks, polls, message effects, and voice notes are only on Stable for now. Use Stable for production agents, and confirm that Beta supports the features you need before you buy a plan.
Photon CLI is a typed command-line client for Photon. Use it to sign in, switch between projects, buy and configure phone numbers and email domains, manage API keys and webhooks, and script all of it from CI. It installs with npm, pnpm, Yarn, or Bun, runs on Node.js 22 or newer, and also ships as a standalone binary for macOS, Linux, and Windows.

​
Start here

Installation

Install the CLI with a package manager or as a standalone binary.

Authentication

Sign in with a device code and manage your stored session.

Service keys

Give automation that acts as your account a non-interactive credential.

Projects

Select an active project and work with its resources.

​
Work with your resources

Platform resources

Buy phone numbers, verify email domains, and route voice calls.

API keys

Issue and revoke project API keys.

Webhooks

Subscribe endpoints to project events.

Organizations

Invite teammates, manage roles, and select an organization.

​
Automation

JSON output

Machine-readable results, errors, and exit codes.

Recoverable operations

Replay a mutation whose result you never saw.