Farcaster API
Follow FID
- API Keys
- Blog
- Community
Farcaster Development Kit
- Getting Started
- GETCast by Hash
- GETCasts
- POSTSend Cast
- DELDelete Cast
- POSTAdd Reaction to Cast
- DELDelete Reaction to Cast
- GETChannels List
- GETChannel By Name
- POSTFollow FID
- DELUnfollow FID
- GETUser By FID
- GETUsers
- Getting Started
- POSTSigners
- POSTRegister Signer with Warpcast
- POSTPoll Warpcast Signer
- GETGet Signers
Info
Casts
Reactions
Links
User Data
Username Proofs
Verifications
FIDs
Storage
Onchain API
Events
Dev Tools
Farcaster API
Farcaster Auth
Hub API Reference
Farcaster API
Follow FID
POST
/
follow
/
{fid}
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
fid
integer
*
fid
Required
integer
Target FID to follow
Add Example Value
signerId
string
*
signerId
Required
string
Signer ID for the user following the target FID
Add Example Value
curl --request POST \
--url https://api.pinata.cloud/v3/farcaster/follow/{fid} \
--header 'Authorization: Bearer <token>'
{
"data": {
"data": {
"type": "MESSAGE_TYPE_LINK_ADD",
"fid": 401191,
"timestamp": 102564169,
"network": "FARCASTER_NETWORK_MAINNET"
},
"hash": "0xc7c8f734f819f1572b4191e003409497a1e71467",
"hashScheme": "HASH_SCHEME_BLAKE3",
"signature": "9ZnWcrrhNKvUbwR/oYnvKw4wnNoU2+LXyTnpQTJm3GChRN7FfIO5oN/u5QIPP7FIlaq8MwnoIU5EbXzWWij9DQ==",
"signatureScheme": "SIGNATURE_SCHEME_ED25519",
"signer": "0x86367a36c3c181c46acdc6027109dbaa75c5fbc97c500af23f1ea8c987f12375",
"dataBytes": "CAUQp74YGMmC9DAgAXIQCgZmb2xsb3cQyYL0MBiHLw=="
}
}
Authorizations
Authorization
string
headerrequiredBearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Path Parameters
fid
integer
requiredTarget FID to follow
Query Parameters
signerId
string
requiredSigner ID for the user following the target FID
Response
200 - application/json
The response is of type object
.
curl --request POST \
--url https://api.pinata.cloud/v3/farcaster/follow/{fid} \
--header 'Authorization: Bearer <token>'
{
"data": {
"data": {
"type": "MESSAGE_TYPE_LINK_ADD",
"fid": 401191,
"timestamp": 102564169,
"network": "FARCASTER_NETWORK_MAINNET"
},
"hash": "0xc7c8f734f819f1572b4191e003409497a1e71467",
"hashScheme": "HASH_SCHEME_BLAKE3",
"signature": "9ZnWcrrhNKvUbwR/oYnvKw4wnNoU2+LXyTnpQTJm3GChRN7FfIO5oN/u5QIPP7FIlaq8MwnoIU5EbXzWWij9DQ==",
"signatureScheme": "SIGNATURE_SCHEME_ED25519",
"signer": "0x86367a36c3c181c46acdc6027109dbaa75c5fbc97c500af23f1ea8c987f12375",
"dataBytes": "CAUQp74YGMmC9DAgAXIQCgZmb2xsb3cQyYL0MBiHLw=="
}
}