FMFansMetric API

Tags

Add Tags to Trial Link

Adds tags (by name) to a trial link. Existing tags are preserved. Requires permission api_tags_bulk_add_trial_links.

https://public-api.fansmetric.com
POST/v1/{account_id}/trial-links/{link_id}/tags
Bearer

Authorization

default
AuthorizationBearer <token>

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

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

  • link_id*integer

    Trial link ID.

Request Body

application/json
  • tags*array

    Tag names. Each must already exist — create tags via Create Tag first.

Response Fields

  • data.tags[]array

    Full tag list on this link after the update.

  • 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/100000001/trial-links/sample_link_id/tags" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "tags": ["Instagram", "Twitter"]
}'

Response

200
{
"data":{
"tags":[
0:{
"id":2
"name":"Instagram"
"color":"#E4405F"
"created_at":"2026-02-04T16:02:10Z"
}
1:{
"id":3
"name":"Twitter"
"color":"#1DA1F2"
"created_at":"2026-01-12T09:15:01Z"
}
]
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

List Trial Link Tags

Next

Remove Tags from Trial Link