# FWD SMS API

> FWD SMS is a Cloudflare-hosted, Twilio-compatible SMS API for application workflows, inbound phone routing, and signed webhooks.

## Documentation

- [Human-readable API docs](https://sms.fwd.dev/docs/): overview, authentication, sending, inbound routing, and webhooks.
- [Plain-text API reference](https://sms.fwd.dev/docs/api.txt): canonical endpoint and payload reference for API clients and coding agents.

## Core Rules

- Base URL: `https://sms.fwd.dev`
- Use application-scoped `fwd_sms_...` API keys.
- Use an account-wide management key with the `sms:manage` scope for application, phone-route, and webhook administration.
- Send JSON to `POST /v1/messages` or form data to the Twilio-compatible Messages endpoint.
- The From number is fixed by the service.
- Webhook requests are signed using the webhook signing secret.
- Never request, infer, or repeat secrets.

## Management API

- `GET /v1/applications`
- `POST /v1/applications`
- `PATCH /v1/applications/:applicationId`
- `PUT /v1/applications/:applicationId/phone-numbers`
- `GET /v1/applications/:applicationId/webhooks`
- `POST /v1/applications/:applicationId/webhooks`
- `DELETE /v1/applications/:applicationId/webhooks/:webhookId`