# Create emoji from URL

Creates a custom emoji by downloading from provided URLs. The emoji file is downloaded, processed, and stored locally. Supports overwriting existing emojis with the same shortcode. Can specify category, visibility, and domain for federated emojis. Requires Emojis.Manage permission (admin only).

RBAC: requires Emojis.Manage

Endpoint: POST /api/v1/custom_emojis
Version: 1.0
Security: 

## Query parameters:

  - `overwrite` (boolean)
    Should existing emojis be overwritten if shortcode matches

## Request fields (application/json):

  - `shortcode` (string, required)

  - `category` (string,null)

  - `url` (string, required)

  - `staticUrl` (string, required)

  - `visibleInPicker` (boolean)

## Response 200 fields (application/json):

  - `shortcode` (string, required)

  - `category` (string,null)

  - `url` (string, required)

  - `staticUrl` (string, required)

  - `visibleInPicker` (boolean)

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 500 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation