# Create Label

Creates an internal label without assigning it to an object. Object tools also create labels on first use. A label is deleted when it is taken off its last object. Name and note cannot contain emoji.

## Input schema:

```json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name, unique within the account, at most 250 characters, without HTML",
      "minLength": 1,
      "maxLength": 250
    },
    "notes": {
      "type": [
        "null",
        "string"
      ],
      "description": "Internal note; omit for none",
      "default": null,
      "maxLength": 1000
    },
    "accountId": {
      "type": [
        "null",
        "integer"
      ],
      "description": "User ID of the account; omit for the account of the access token",
      "default": null,
      "minimum": 1
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}
```

## Output schema:

```json
{
  "type": "object",
  "required": [
    "accountId",
    "labelId",
    "name",
    "notes",
    "usageCount",
    "usedBy",
    "editUrl"
  ],
  "properties": {
    "accountId": {
      "type": "integer"
    },
    "labelId": {
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "usageCount": {
      "type": "integer"
    },
    "usedBy": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "id",
          "name",
          "type"
        ],
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string"
          }
        }
      }
    },
    "editUrl": {
      "type": "string"
    }
  }
}
```