Create Tag

Creates a new link tag. Max 500 tags per organization. Names must be unique. Requires permission api_tags_create.

https://public-api.buffmetrics.com

POST/v1/tags

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Request Body

application/json

name*string
Tag name (unique per org).
color*string
Hex color, e.g. #93c5fd.

curl --request POST "https://public-api.buffmetrics.com/v1/tags" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "name": "Reddit",
  "color": "#93c5fd"
}'

Response

201

{"data":{"tag":{"id":5
"name":"Reddit"
"color":"#93c5fd"
"created_at":"2026-05-14T12:00:00Z"
}
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Tags

Set Tracking Link Tags