Beta software notice

Smithereen is still in beta. Nothing about the API is finalized yet and everything is subject to change until Smithereen 1.0 is released. If you're building something with the API, please join the Telegram chat to share feedback and stay up to date on any potential breaking changes.

Creating an app

Smithereen apps are identified by a URL that points to an Application ActivityPub object. You can either self-host one, or use your account on any Smithereen server to create one. Learn more »

You only need an app identity if you would like to make authenticated API requests.

Right now, only standalone apps are supported. Support for iframe apps, those that run in an iframe on a Smithereen server, will come later.

User authentication

Obtain an access token to make API requests on behalf of a user. Learn more »

Interacting with the API

API methods