Skip to main content
GET
/
v2
/
farcaster
/
app_host
/
user
/
event
Generate event
curl --request GET \
  --url https://api.neynar.com/v2/farcaster/app_host/user/event/ \
  --header 'x-api-key: <api-key>'
{
  "event": "<string>",
  "notificationDetails": {
    "token": "<string>",
    "url": "<string>"
  }
}

​
Node.js SDK

🔗 SDK Method: appHostGetEvent Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience.

Authorizations

​
x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Query Parameters

​
app_domain
string
required

The domain of the mini app

Example:

"demo.neynar.com"

​
fid
integer
required

The FID of the user who initiated the event

Required range: x >= 1
​
event
enum<string>
required

The type of event

Available options:
frame_added,
frame_removed,
notifications_enabled,
notifications_disabled

Response

Success

​
event
string
required

Legacy event type corresponding to the requested event type:

  • frame_added: User adds a mini app to their account
  • frame_removed: User removes a mini app from their account
  • notifications_enabled: User enables notifications for a mini app
  • notifications_disabled: User disables notifications for a mini app
​
notificationDetails
object

Details for notification setup, only present when event is notifications_enabled