emojis_create
emojis_create
Section titled “emojis_create”Category: emojis
Upload a new custom emoji to a guild.
When to use
Section titled “When to use”- Programmatic onboarding of brand emojis.
When NOT to use
Section titled “When NOT to use”- Application-wide emojis → use
app_emojis_create. - Image > 256KB before base64 → Discord rejects.
| Field | Type | Required | Description |
|---|---|---|---|
guild_id | string | yes | Target guild |
name | string | yes | Emoji name (2-32 chars) |
image | string | yes | Emoji image as a base64 data URI (e.g. “data:image/png;base64,…”) |
roles | array | no | Roles allowed to use this emoji (omit for everyone) |
audit_reason | string | no | Reason recorded in audit log (X-Audit-Log-Reason header) |
Returns
Section titled “Returns”\{id, name, animated, roles\}. Image MUST be a base64 data URI.
Output schema
Section titled “Output schema”| Field | Type | Required | Description |
|---|---|---|---|
id | unknown | yes | |
name | unknown | yes | |
animated | boolean | yes | |
roles | array | yes |
Annotations
Section titled “Annotations”| Property | Value |
|---|---|
| Read-only | no |
| Destructive | no |
| Idempotent | no |
| Open-world | yes |
| Confirmation required | no |