# Bulk import emojis from ZIP upload

Imports multiple emojis from a ZIP archive that was previously uploaded via /uploads. 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.

RBAC: requires Emojis.Manage

Endpoint: POST /api/v1/custom_emojis/import/upload
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

  - `uploadId` (string, required)
    ID of the previously created upload containing the ZIP archive
    Example: "us_01hxcvk1hjexere4pvtrj0ymqq"

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

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