Skip to Content
DevelopersAPI referenceTime

Create tag

POST
/v1/tags

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (blk_…) from Settings → API keys.

Request Body

application/json
  1. body
name*string
Length1 <= length <= 60
color?|
Value in"gray""green""teal""blue""violet""pink""red""orange""amber"null

Response Body

application/json
  1. response
id*string
name*string
color*|
Value in"gray""green""teal""blue""violet""pink""red""orange""amber"null
Example Request
curl -X POST 'https://your-billleaf-api/v1/tags' \  -H 'Content-Type: application/json' \  -d '{  "name": "string"}'
Example Response201
{  "id": "string",  "name": "string",  "color": "gray"}