FMFansMetric API

Tags

Create Tag

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

https://public-api.fansmetric.com
POST/v1/tags
Bearer

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.

Response Fields

  • dataobject | array

    Endpoint-specific payload. See the fields below for this route.

  • _meta._credits.usedinteger

    Credits consumed by this request (currently always 1).

  • _meta._rate_limits.limit_minuteinteger

    Maximum requests per minute for the organization.

  • _meta._rate_limits.remaining_minuteinteger

    Remaining requests in the current minute window.

  • _meta._rate_limits.limit_dayinteger

    Maximum requests per day for the organization.

  • _meta._rate_limits.remaining_dayinteger

    Remaining requests in the current day window.

curl --request POST "https://public-api.fansmetric.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
}
}
}

Previous

List Tags

Next

Set Tracking Link Tags