Webhooks

Pro

Stream MGS Link events into your own systems. Available on Pro and Enterprise.

Coming soon

The webhook delivery system is wired and tested internally. We're holding it back until we ship signing-key rotation and a delivery dashboard.

Planned events

Event	When it fires
verification.completed	A user successfully linked their Roblox account.
verification.failed	A verification attempt failed. Includes the reason.
member.unlinked	A member unlinked or was unlinked by an admin.
role.synced	A role-sync job completed for a member, with adds/removes.
role.sync_failed	A sync job failed (Discord rate limit, hierarchy, etc).
guild.suspended	A guild was suspended by a platform admin.

Delivery shape (preview)

POST https://your-endpoint.example.com/mgslink
content-type: application/json
x-mgslink-signature: t=1727640000,v1=<hmac-sha256>
x-mgslink-event: verification.completed
x-mgslink-delivery: 01J9V6AJ8QH7M9N9Z5T2P3FC9X

{
  "id": "evt_01J9V6AJ8QH7M9N9Z5T2P3FC9X",
  "event": "verification.completed",
  "createdAt": "2027-09-29T18:00:00.000Z",
  "guildId": "900000000000000001",
  "data": {
    "discordUserId": "300000000000000002",
    "robloxUserId": "156",
    "robloxUsername": "Builderman"
  }
}

Signatures use HMAC-SHA256 over the raw request body and a per-endpoint secret. Failed deliveries are retried with exponential backoff for up to 24 hours.

Want early access? Get in touch →