Skip to content

Feature Request: Webhook API for Project Updates #3854

Open
@serverside-swzo

Description

@serverside-swzo

Please confirm the following.

  • I checked the existing issues for duplicate feature requests
  • I have checked that this feature request is not on our roadmap

What parts of Modrinth is your feature request related to?

API, Project Management, Automation, Discord Integration

Is your suggested feature related to a problem? Please describe.

It’s currently not possible to automatically notify a community (like a Discord server) when a Modrinth project gets updated. Projects have no way to push update events to external services, users need to either check manually or use API polling.

Describe the solution you'd like

Feature Request: Webhook API for Project Updates

Modrinth should support webhooks for project updates, similar to GitHub’s webhooks for repositories. This would allow external services (like bots or tools) to instantly react when a new version is published.

Example use case:

A Discord bot could listen for updates to a modpack or resource pack and automatically post in a channel when a new version is released.
For instance, if a project like "Generic Mod" is updated, it could trigger a webhook that sends this message:

🆕 Generic Mod was just updated!
📦 Version: v2.3.1  
📝 Changelog: Added new blocks and fixed crash on startup  
📅 Published: 2025-06-28  
🔗 https://modrinth.com/mod/generic-mod/version/v2.3.1

Suggested functionality:

  • Project owners can register one or more webhook URLs in the Modrinth project settings
  • Webhook is triggered when a new version is published
  • The payload could be JSON and include:
    • project_name
    • project_slug
    • version_name
    • version_number
    • changelog (if provided)
    • release_type (release, beta, alpha)
    • published_at
    • version_url

This would remove the need for third-party polling or scraping, and enable tight integration with community tools, Discord bots, or modpack dashboards.

A system similar to how GitHub handles webhooks (configurable events, JSON payloads, secure tokens, etc.) would be ideal.

Describe alternatives you've considered

  • Polling the Modrinth API every few minutes, inefficient and could be rate-limited
  • Relying on user-submitted changelog reposting, not automated or reliable

Additional context

This would be useful across all project types (mods, modpacks, resource packs, plugins). It’s especially helpful for community-run servers, launcher automation, and projects that want to keep their users informed the moment something new goes live.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions