For Agents
Push purchase, signup, and engagement events into Fomo to trigger on-site social proof notifications, and manage templates and application settings.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Fomo API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Fomo API API.
Create social proof events such as purchases or signups via /applications/me/events
List, retrieve, update, and delete existing events by ID
Define and manage notification templates that style how events appear
Read application-level statistics for engagement reporting
GET STARTED
Use for: I need to push a new purchase event into Fomo, I want to list all events in my Fomo application, Find a Fomo event by its ID, Get engagement statistics for the connected Fomo application
Not supported: Does not handle email delivery, SMS, or transactional payments — use for Fomo on-site social proof events, templates, and application stats only.
Jentic publishes the only available OpenAPI document for Fomo API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Fomo API, keeping it validated and agent-ready. Fomo is a social proof automation platform that displays real customer activity — recent purchases, signups, reviews — as on-site notifications. The API exposes endpoints for creating and managing events, defining notification templates, reading application statistics, and configuring application settings. Authentication uses a token in the Authorization header.
Inspect or update settings on the connected Fomo application
Backfill historical events for new on-site notification campaigns
Patterns agents use Fomo API API for, with concrete tasks.
★ On-Site Social Proof from Purchases
Forward order events from your store to Fomo via POST /applications/me/events so the platform displays a real-time 'someone in Berlin just bought X' notification on your site. Suits e-commerce teams that want to lift conversion through trust signals without building their own notification infrastructure. Setup typically takes a couple of hours including event mapping.
Create a Fomo event via POST /applications/me/events with type 'order' and a payload describing a purchase of $49 by a customer in 'Berlin, DE'.
Template Management for Brand Consistency
Manage notification templates through /applications/me/templates so the social proof popups match your brand voice and visual style. Useful when running multi-language stores or different campaigns per product line. Templates can be created, listed, and applied to specific event types.
List templates via GET /applications/me/templates and return the IDs and names of templates whose name contains 'order'.
Application Statistics Reporting
Pull engagement metrics for your Fomo application through GET /applications/me/statistics to feed dashboards and weekly reports. The endpoint surfaces aggregate counts that quantify how social proof is performing without the team logging into the Fomo dashboard. Combine with your analytics warehouse for end-to-end attribution.
Call GET /applications/me/statistics and return the top-line engagement counters for the connected Fomo application.
AI Agent Social Proof Integration via Jentic
Agents use Jentic's intent search to find Fomo operations, load the schema for the events endpoint, and execute calls under a scoped credential. This is the recommended path for assistants that pipe order or signup events from a CRM or ecom backend into Fomo without exposing the raw token. Jentic keeps credentials isolated.
Use Jentic to search 'create a Fomo event', load the POST /applications/me/events schema, and create an event for a recent order with the values supplied by the user.
8 endpoints — jentic publishes the only available openapi specification for fomo api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/applications/me/events
List events for the connected application
/applications/me/events
Create a new social proof event
/applications/me/events/{id}
Retrieve an event by ID
/applications/me/events/{id}
Update an event
/applications/me/events/{id}
Delete an event
/applications/me/templates
List notification templates
/applications/me/statistics
Read application engagement statistics
/applications/me
Read application settings
/applications/me/events
List events for the connected application
/applications/me/events
Create a new social proof event
/applications/me/events/{id}
Retrieve an event by ID
/applications/me/events/{id}
Update an event
/applications/me/events/{id}
Delete an event
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Fomo Authorization token is stored encrypted in the Jentic vault (MAXsystem). Agents receive a scoped execution token and never see the raw token, which keeps it out of prompts and logs.
Intent-based discovery
Agents search by intent (e.g. 'create a Fomo event') and Jentic returns the POST /applications/me/events operation with its input schema, so the agent posts the right event type without browsing Fomo docs.
Time to first call
Direct Fomo integration: 1 day for auth wiring, event modelling, and template configuration. Through Jentic: under an hour — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Klaviyo API
Email and SMS marketing platform that pairs with Fomo's on-site social proof.
Use alongside Fomo when the same customer events should drive both on-site notifications and email or SMS campaigns.
Customer.io API
Event-driven messaging that consumes the same customer activity stream as Fomo.
Pair with Fomo when an event needs to trigger both an on-site notification and a multi-channel messaging campaign.
Mailchimp API
Email marketing platform for follow-ups to the visitors Fomo notifications convert.
Use alongside Fomo when the team wants to retarget engaged on-site visitors via email campaigns.
Specific to using Fomo API API through Jentic.
Why is there no official OpenAPI spec for Fomo API?
Fomo does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Fomo API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Fomo API use?
The Fomo API uses a token issued from the Fomo dashboard, passed in the Authorization header. Jentic stores the token encrypted in the MAXsystem vault and injects it on outbound calls so the agent never holds the raw secret.
Can I create custom event types with the Fomo API?
Yes, POST /applications/me/events accepts arbitrary event payloads that you can map to templates defined in /applications/me/templates. This is how you display custom on-site notifications such as signups, downloads, or reviews.
What are the rate limits for the Fomo API?
The OpenAPI spec does not declare explicit rate limits. Apply client-side throttling for bulk backfills and back off on 429 responses returned by the service.
How do I push order events from my store through Jentic?
Search Jentic for 'create a Fomo event', load the POST /applications/me/events schema, and execute with the order details. Jentic handles auth and request shaping so the agent only supplies the order fields.
Can the Fomo API delete or update existing events?
Yes, /applications/me/events/{id} supports retrieval, update, and deletion of an event by its ID. Use this to correct test events or remove events that should not appear as social proof.
/applications/me/templates
List notification templates
/applications/me/statistics
Read application engagement statistics
/applications/me
Read application settings