# Bulk import emojis from ZIP

Imports multiple emojis from a ZIP archive. Filenames (without extension) become emoji shortcodes. All imported emojis share the same category and visibility settings. Images are automatically resized to 128x128 if larger. Animated GIFs are preserved with static versions generated. Supports batch overwriting of existing emojis. Requires Emojis.Manage permission (admin only).

RBAC: requires Emojis.Manage

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

## Query parameters:

  - `category` (string, required)
    Category of the imported emojis

  - `domain` (string,null)

  - `overwrite` (boolean)
    Should existing emojis be overwritten if any of the shortcodes match

  - `visible` (boolean, required)
    Whether the imported emojis should be visible in the picker

## Request fields (multipart/form-data):

  - `file` (string, required)

## 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