Update Fan Note

Writes your team's note about a fan on one account, creating it if there is not one yet. Leaves the note OnlyFans keeps untouched. Requires permission api_fm_fans_update_note.

https://public-api.fansmetric.com

PATCH/v1/{account_id}/fm/fans/{fan_id}/note

API keyBearer

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.
fan_id*integer
Fan's OnlyFans numeric user ID.

Request Body

application/json

body*object
Note text. "" is stored and returned as "". Omitting the key, or sending null, returns 400.

Response Fields

data.bodystring
The note now stored.
data.created_atstring
Unchanged by an update — it records the first write.
data.updated_atstring
Refreshed on every write.
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.

Field	Type	Description
data.body	string	The note now stored.
data.created_at	string	Unchanged by an update — it records the first write.
data.updated_at	string	Refreshed on every write.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request PATCH "https://public-api.fansmetric.com/v1/100000001/fm/fans/XXXXX/note" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "body": "Prefers voice notes. Buys on Fridays."
}'

Response

200

{"data":{"body":"Prefers voice notes. Buys on Fridays."
"created_at":"2026-09-10T21:04:52Z"
"updated_at":"2026-09-10T21:04:53Z"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Fan NoteFM

Get Fan LinksFM