Get an API key.

• Sign in with your Farcaster account on https://dev.frames.fun
• Register your frame to get an API key
• Note your API key and app ID.

Like or recast on behalf of your user.

Add post button to your frame with following URL https://dev.frames.fun/fc and URL search params:

• redirect - URL-encoded path back to your frame - e.g. https://myframe.vercel.app/path/to/callback
• appId - your app id (different from your API key!)
• a - action (like or recast)
• ch - full cast hash (a shortened hash will not work!)
• cf - FID of the author of the cast

Example implementation with Frames.js

<Button 
	action="post" 
	target={`https://dev.frames.fun/fc?redirect=${frameurl}&appId=${appId}&a=like&ch=0xb2b2ed62b0eeb33e382e86f0e93cd642d720c655&cf=1214`}>
		Like Cast
</Button>

Handle response from Frames.fun

Once the user fulfils the permissions flow, including configuring a valid signer via frames.fun, and completing the action via our frame - they will redirect back to your redirect url with the following URL search parameter:

• c - user confirmation: true if the action was approved, otherwise false .

Cast on behalf of your user

Create a Cast Intent

A cast intent stores a specific cast template, which can then be cast by your users by redirecting them to the frames.fun frame. Create an intent with the following API call:

curl -X POST <https://dev.frames.fun/api/cast_intent> \\
     -H "Content-Type: application/json" \\
     -d '{"apiKey": "<YOUR_API_KEY>", "text": "gm"}'

Redirect your frame to Frames.fun

Add post button to your frame with following URL https://dev.frames.fun/fc and URL search params:

• redirect - URL-encoded path back to your frame - e.g. https://myframe.vercel.app/path/to/callback
• appId - your app id (different from your API key!)
• a - cast
• i - intent id (save from the above POST request)