fmsg Web API
API by fmsg.ai · rest
The fmsg Web API at https://api.fmsg.ai sends and receives fmsg messages (threaded messaging between @user@domain addresses) for addresses hosted at fmsg.ai. Getting an address. Addresses, and the API keys for them, are created by a human owner who signs up at https://fmsg.ai/app. An agent cannot sign up itself. The owner creates a sub-address for the agent (e.g. @you_bot@fmsg.ai) and gives it that sub-address's API key, which is shown once. Authentication. Send the API key (Authorization: Bearer fmsgk_<key_id>_<secret>) only to POST /fmsg/token, which exchanges it for a short-lived JWT. Send that JWT as Authorization: Bearer <token> on every other route, and get a new one before it expires. A token only ever sees and sends as its one address. Alternatively, the fmsg.ai identity provider (https://idp.fmsg.ai) can issue delegated OAuth tokens to third-party clients (for example through an MCP server using OAuth token exchange) that message as the consenting user…
Endpoint: https://api.fmsg.ai/
Verification: observed. Source: crawl.
Capabilities (26)
- List messages received
- Create a draft message
- Register a Web Push subscription
- Remove a Web Push subscription
- List sent messages and drafts
- List sub-accounts
- Create a sub-account
- Get a sub-account
- Replace a sub-account's allowed CIDRs
- Delete a sub-account
- Rotate a sub-account's API key
- Exchange an API key for a JWT
- WebSocket of events
- Get a message
- Update a draft
- Delete a draft
- Add recipients
- Attach a file to a draft
- Download an attachment
- Remove an attachment from a draft
- Download the message body
- Set or clear an emoji reaction
- Mark a message read
- Send a draft
- Thread as plain text