---
search:
  tags:
    - administration
    - POST
seo:
  description: >-
    Creates a new custom icon for the workspace. Reference for the POST
    /administration/custom-icons endpoint in the Leadtime Public API API.
sidebar:
  badge: POST
  label: Create custom icon
title: Create custom icon
type: openapi-operation
---
Creates a new custom icon for the workspace.

**What are Custom Icons?**
Custom icons are user-uploaded symbols (images) that can be used throughout the workspace to visually organize and tag content. They help make information easier to grasp quickly.

**How to create a custom icon:**
1. Upload an image file (PNG or SVG format) using POST /api/public/workspace/upload
2. Get the file ID from the upload response
3. Provide a unique icon name (e.g., `:company_logo:`, `:team_sales:`, `:lt_editor:`)
4. Use the file ID in the `imageId` field

**Icon name requirements:**
- Must be alphanumeric characters and underscores only
- Cannot conflict with default emoji names
- Format: typically wrapped in colons (e.g., `:icon_name:`)

**Note:** This endpoint requires the `CustomIcons.create` permission. Once created, the icon is available to all users in the workspace and can be used in projects, tickets, documents, and profiles.

<Operation source="api-reference" id="customiconscontroller-createcustomicon" />