Build for Moymo
Moymo has a platform for people who build things: applications, bots and "Continue with Moymo". This is where it is written down.
QuickstartMake an application, give it a bot, add the bot to your own server, and call the API. About ten minutes.OAuth2 guideLet people sign in to your site or app with their Moymo account, and read what they agree to share.InteractionsSlash commands, buttons, menus and forms: how Moymo sends them to your server, signed, and how you answer.API referenceEvery endpoint a bot or an authorised app can call, with the request and the answer.
The parts
| Part | What it is | Where |
|---|---|---|
| Developer Portal | Where you make and manage applications: names, pictures, secrets, bots, domains, testers, publishing. | developer.moymo.net |
| Application | The thing you make. It can have a bot, a client id and secret for sign-in, or both. | Applications |
| Bot | A member of a server that your code controls. It has a token, a username and a BOT tag. | Bots |
| OAuth2 | "Continue with Moymo": a member lets your app see their username, picture or servers. | OAuth2 guide |
| App API | The HTTPS API that bots and authorised apps call. Versioned on its own: /api/app/v1. | Reference |
What works today, and what is coming
The platform is being built in phases, and this wiki says plainly which is which.
| Today | Planned | |
|---|---|---|
| Applications | Make, describe, brand, delete; draft and published; testers; audit log | Teams, the App Directory |
| Domain verification | TXT record, checked now and every few hours | - |
| Bots | Create, token, username, picture, intents; add to a server with a managed role and chosen permissions; read and write messages with embeds and buttons; channels, roles, members, bans, reactions, pins | The gateway (WebSocket); webhooks; files on messages |
| Interactions | Slash commands and context-menu commands, buttons, select menus, forms (modals), autocomplete, ephemeral and deferred answers, signed endpoint | Attachment options, layout components, command permission overrides |
| OAuth2 | Authorization code with PKCE, refresh tokens, revoke, "Connected apps" in settings; scopes identify, email, servers, bot | Scopes for libraries, playtime, profile and friends; client credentials |
| Developer tools | Developer mode in the Servers add-on copies any id | SDKs, starting with a JavaScript one |
The full plan, set beside what Discord offers, is in the roadmap.
Conventions
- IDs are UUIDs, as everywhere in Moymo: a string like
0f6c1a52-3b9e-4c1c-9d1b-6e7d2a8f4b10. They are strings in JSON, never numbers. - Times are ISO 8601 in UTC:
2026-11-03T14:05:00Z. - Secrets carry a prefix that says what they are (
moymo_bot_,moymo_cs_,moymo_at_,moymo_rt_), are shown once, and are stored only as a hash. See Tokens and secrets. - Errors have one shape, described in Errors.
Getting help
If something here is wrong or missing, every page has a Suggest a change to this page link at the bottom. If something does not behave as documented, say what you sent and what you got back; the traceId in an error answer lets us find the request.