Skip to main content
PUT
/
v1
/
guilds
/
{guild_id}
/
vanity
curl -X PUT https://hapi.7331.org/v1/guilds/987654321098765432/vanity \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"vanity_invite": "my-cool-guild"}'

{
  "discord_id": "987654321098765432",
  "name": "My Cool Guild",
  "avatar_url": "https://cdn.discordapp.com/icons/987654321098765432/abc.png?size=1024",
  "has_premium": true,
  "member_count": 150,
  "prefix": "!",
  "subscription_expires_at": null,
  "source": "database",
  "created_at": "2025-06-01T00:00:00Z",
  "updated_at": "2026-03-11T10:00:00Z"
}
Requires an active session cookie. The caller must be the guild owner, guild sponsor, or ADMIN+. The guild must have an active premium subscription.
​
guild_id
integer
required
Discord snowflake ID of the guild.
​
vanity_invite
string
required
Vanity invite slug. Must match ^[a-z0-9][a-z0-9\-]{1,30}[a-z0-9]$.

​
Response

Returns the updated guild object.
​
discord_id
string
required
Discord guild ID.
​
name
string
required
Guild name.
​
has_premium
boolean
Whether the guild has active premium.
​
member_count
integer
Number of members in the guild.
​
prefix
string
Command prefix for this guild.
curl -X PUT https://hapi.7331.org/v1/guilds/987654321098765432/vanity \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"vanity_invite": "my-cool-guild"}'

{
  "discord_id": "987654321098765432",
  "name": "My Cool Guild",
  "avatar_url": "https://cdn.discordapp.com/icons/987654321098765432/abc.png?size=1024",
  "has_premium": true,
  "member_count": 150,
  "prefix": "!",
  "subscription_expires_at": null,
  "source": "database",
  "created_at": "2025-06-01T00:00:00Z",
  "updated_at": "2026-03-11T10:00:00Z"
}