search_event
Search Event
Search for a Fomo event by **email address** or **external ID**. Returns the most recently created event matching the query. Useful for looking up events before updating or deleting them.
search_event
Search for a Fomo event by **email address** or **external ID**. Returns the most recently created event matching the query. Useful for looking up events before updating or deleting them.
create_event
Create a new Fomo notification event. Events represent customer activity (purchases, signups, reviews, etc.) that appear as social proof notifications on your website. Each event must reference a template via **eventTypeId** or **eventTypeTag**.
update_application
Update Fomo application settings that control how notifications are displayed to visitors on your website, including position, timing, theme, and UTM tracking parameters.
create_template
Create a new Fomo notification template (event type). Templates define the display format for notifications using variable placeholders like `{{ first_name }}`, `{{ city }}`, `{{ title_with_link }}`, and `{{ time_ago }}`. Useful for building 3rd-party Fomo integrations.
update_event
Update an existing Fomo event's fields. Only the fields you provide will be changed; all other fields remain unchanged.
get_event
Retrieve a single Fomo event by its ID. Returns the full event including the rendered notification message and all associated fields.
list_events
List all Fomo events with pagination support. Returns events along with pagination metadata (current page, total pages, total count).
get_open_metrics
Retrieve Fomo's public marketing KPIs via the Fomo Open API. This is a **public, unauthenticated** endpoint that returns Fomo's own platform-level metrics (not your application's data). Available metrics: signups count, customers count, and integrations.
delete_event
Delete a Fomo event by its ID. This permanently removes the notification from your live feed. Useful for building "opt out" functionality or cleaning up test events.
get_statistics
Retrieve notification performance statistics for a date range including impressions, clicks, hovers, conversions, and sales data. Returns both daily breakdowns and aggregated totals.
Manage social proof notifications that display real-time customer activity (purchases, signups, reviews) on websites. Create, retrieve, search, update, and delete notification events with details like customer name, location, and custom attributes. Manage notification templates that define display formats using variable placeholders. Retrieve application statistics and update display settings for how notifications appear to site visitors. Search events by specific fields and values. Access Fomo's public marketing metrics including signup counts, customer counts, and integrations.
Common questions about connecting Fomo to AI agents with Metorial.