---
title: "Send event"
method: POST
path: "/v2/farcaster/app_host/user/event/"
tags: ["App Host"]
---

# Send event

`POST /v2/farcaster/app_host/user/event/`

Post an app_host event to the domain's webhook. Events such as enabling or disabling notifications for a user. Provide either a signed message or the signer UUID of an authorized neynar-hosted signers.

## Request body

- union — Request body for app host events. Can either provide a signed_message or a signer_uuid with event details.
  - SignedMessageBody
    - `app_domain` string, required — Domain of the mini app
    - `signed_message` union, required — JFS-signed message containing the event payload. The message must be properly signed and contain valid event information. Can be provided as a single string or json object.
      - string
      - EncodedJsonFarcasterSignature — Encoded JSON Farcaster signature
        - `header` string, required
        - `payload` string, required
        - `signature` string, required
  - SignerUuidBody
    - `app_domain` string, required — Domain of the mini app
    - `event` 'frame_added' | 'frame_removed' | 'notifications_enabled' | 'notifications_disabled', required — Types of events that can occur between a user and an app host: - 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
    - `fid` integer, required — The unique identifier of a farcaster user or app (unsigned integer)
    - `signer_uuid` string, required — UUID of the signer. `signer_uuid` is paired with API key, can't use a `uuid` made with a different API key.

## Response `200`

Success

- AppHostPostEventResponse
  - `message` string
  - `success` boolean, required

## Other responses

- `400` — Bad Request
- `404` — Resource not found
- `500` — Server Error
- `502` — Bad Gateway

---

[API](https://skmtc.dev/neynar/apis/neynar-api.md) · [All operations](https://skmtc.dev/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neynar/neynar-api/revisions/dbb91bfb0d1a/schema)