API reference

Registration

The registration message is how members link their Epic account in Discord. Configure its embeds and buttons over the API, then post it to a channel.

All paths are relative to https://api.zyron.pro/api/v1/guilds/:guildId. Linked accounts themselves are managed on the Members & links page.

Get registration config

GET/guilds/:guildId/registration-config

Returns the full registration message configuration.

json

{
  "embed": {
    "title": "Link your Epic account",
    "description": "Click the button below to link your Epic Games account and unlock tournaments.",
    "color": "#5865F2"
  },
  "embeds": [],
  "button": { "label": "Register", "emoji": "🎮" },
  "button2": null,
  "twitch": { "enabled": false, "channel": null },
  "options": {
    "requireEpicLink": true,
    "assignVerifiedRole": true
  }
}

Update registration config

PATCH/guilds/:guildId/registration-config

Partial update — send only the sections you want to change. Returns the full updated config.

Field	Type	Description
`embed`	`object`	The primary embed shown on the registration message (title, description, color, image, and so on).
`embeds`	`object[]`	Additional embeds, `1–10` total across the message. Replaces the existing extra-embed list when sent.
`button`	`object`	The primary registration button (label, emoji).
`button2`	`object \| null`	Optional secondary button. Send `null` to remove it.
`twitch`	`object`	Twitch integration settings shown alongside registration.
`options`	`object`	Behavioral options — e.g. whether an Epic link is required and whether the verified role is assigned automatically.

curl -X PATCH https://api.zyron.pro/api/v1/guilds/123456789012345678/registration-config \
  -H "Authorization: Bearer zyr_your_guild_key" \
  -H "Content-Type: application/json" \
  -d '{
    "embed": {
      "title": "Link your Epic account",
      "description": "Click Register below to get verified.",
      "color": "#5865F2"
    },
    "button": { "label": "Register" }
  }'

Post the registration message

POST/guilds/:guildId/registration-config/send

Posts (or re-posts) the configured registration message to a channel. Members click its button to start linking their Epic account.

Field	Type	Description
`channelId`required	`string`	The target channel. Use `GET /channels` to enumerate valid IDs.

bash

curl -X POST https://api.zyron.pro/api/v1/guilds/123456789012345678/registration-config/send \
  -H "Authorization: Bearer zyr_your_guild_key" \
  -H "Content-Type: application/json" \
  -d '{ "channelId": "111111111111111111" }'

Edit first, send second

The message is rendered from the config at send time — update the config with PATCH first, then POST /send to publish the result.

Errors

400 invalid_request for more than 10 embeds or a malformed embed/button; 404 not_found for an unknown channelId. See Errors for the shared codes.