What is the Beep API

The Beep Platform API is a programmatic SMS send API with configurable reply routing and delivery-status callbacks. Send single or batch text messages, control where recipient replies are routed, and subscribe to the lifecycle of every message you send.

Core concepts

Beep is multi-tenant with a three-level hierarchy:

• Organization — the top-level account. Organization-scoped API keys can act on any workspace in the organization.
• Workspace — a sending context with its own phone number(s), settings, and inbox. Every API request resolves to exactly one workspace.
• Messaging — you send messages from a workspace; recipient replies are routed by that workspace's reply-destination rules, and delivery status is reported via callbacks.

Two independent notification mechanisms

• Reply destinations are inbound — they decide where a recipient's reply goes (a webhook or the Beep inbox).
• Status callbacks are outbound-facing — they report the lifecycle of messages you sent.

They are configured separately and never overlap. See the Quickstart to wire both end to end.

Next steps

• Create an API key
• Authentication & workspace scoping
• Send your first message (Quickstart)