Sample - Slack Web API
POST/admin.emoji.add

Add a custom emoji

Adds a custom emoji to an Enterprise Grid organization. Provide the emoji name and an image url so the organization can use the new emoji.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

3 body fields

Form data defining the custom emoji and its source image. token, name, and url are required.

tokenstringrequired
Authentication token. Requires scope: `admin.teams:write`
namestringrequired
The name of the emoji to be removed. Colons (`:myemoji:`) around the value are not required, although they may be included.
urlstringrequired
The URL of a file to use as an image for the emoji. Square images under 128KB and with transparent backgrounds work best.

2 status codes
200Returns an object containing `ok: true` when the custom emoji is added.
okbooleanrequired
Allowed:true
defaultReturns an object containing `ok: false` when the custom emoji cannot be added.
okbooleanrequired
Allowed:false

Error handling

token, name, and url are required. The name may include surrounding colons, and url must identify the image to use for the emoji. Use a token with the admin.teams:write scope.