melonly logomelonly logo
melonly logo
Dashboard
Log in

Melonly API

Build bots and tools on top of your Melonly server with the Melonly API.

What is the Melonly API?

The Melonly API lets your own bots and tools work with your server. You can read your logs, shifts, infractions, leave and more, and create or change them too.

Anything you do through the API works just like doing it in Melonly. If your bot creates a log, it's posted to your log channel and the player gets their DM, exactly as if a staff member had logged it from the Mod Panel.

What Can I Build?

IdeaEndpoints you'd use
A Discord command that logs a punishmentMembers, Logs
A "who's on shift" status boardShifts
A bot that starts and ends shifts from DiscordShifts
A staff lookup that shows someone's recordLogs, Infractions
A leave request form on your own websiteLeave of Absence
A dashboard for your CADCAD

Quick Start

  1. Create a Token

    In your dashboard, go to Settings, then Server API Tokens, and click Create token. See Server API Tokens.

  2. Make Your First Request

    Send the token in the Authorization header. This gets your server's details:

    curl https://api.melonly.com/api/v1/server/info \
      -H "Authorization: Bearer YOUR_TOKEN"
  3. Read the Response

    You get your server back under data:

    {
      "data": {
        "id": "7294057520392310784",
        "name": "Nelly's Liberty County",
        "premium": true
      }
    }

Every request goes to https://api.melonly.com/api/v1, followed by the endpoint's path.

Try It in Your Browser

The API explorer lists every endpoint and lets you send requests with your token. It's built from the API itself, so it always matches what's live. The raw OpenAPI spec works with tools like Postman and code generators.

🧭 Quick Navigation

Need help?

Still have questions? Join our Discord server for support from the Melonly Team.