Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Novu 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.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnovu.co%2Fnovu" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnovu.co%2Fnovu" | 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 Novu API.
Trigger notifications across email, SMS, push, in-app, and chat channels with a single event call
Define multi-step notification workflows with conditional routing and delay logic
Fan out notifications to subscriber groups via topic-based pub/sub
Track per-subscriber notification preferences and channel opt-in status
Route messages through multiple provider integrations with automatic failover
GET STARTED
Broadcast announcements to all subscribers without individual addressing
Manage notification templates and layouts with preview and localization support
Patterns agents use Novu API for, with concrete tasks.
★ AI Agent Notification Orchestration
AI agents trigger multi-channel notifications through Jentic by searching for the event trigger operation, loading the schema, and executing with the event name, subscriber ID, and payload. Jentic handles ApiKey injection from your Jentic One instance. A single POST to /v1/events/trigger delivers the notification across all channels defined in the workflow - email, SMS, push, in-app, and chat - without the agent managing individual provider integrations.
Trigger a notification event named 'order-shipped' for subscriber 'user-123' with payload containing order_id and tracking_url via POST /v1/events/trigger
Subscriber Preference Management
Allow end users to control which notification channels they receive messages on. The API exposes per-subscriber, per-workflow preference endpoints that respect opt-out choices at delivery time. Agents can read and update preferences programmatically, enabling self-service notification settings without building custom preference UIs from scratch.
Retrieve notification preferences for subscriber 'user-456' via GET /v2/subscribers/{subscriberId}/preferences and disable the email channel for the 'marketing-updates' workflow
Topic-Based Fan-Out
Group subscribers into topics and send a single trigger to notify all members simultaneously. Topics support dynamic membership - subscribers can be added or removed at any time. This pattern handles use cases like product update announcements, team notifications, and event alerts without maintaining recipient lists in application code.
Create a topic named 'product-updates' via POST /v2/topics, add 3 subscribers to it, then trigger a broadcast notification to the topic
In-App Notification Feed
Power an in-app notification center by fetching a subscriber's notification feed with read/unread status. The API supports marking individual messages or all messages as read, tracking unseen counts for badge displays, and filtering by notification category. This eliminates the need to build notification storage and retrieval infrastructure.
Fetch the notification feed for subscriber 'user-789' via GET /v1/subscribers/{subscriberId}/notifications/feed and mark all as read via POST /v1/subscribers/{subscriberId}/messages/mark-all
102 endpoints — jentic publishes the only available openapi specification for novu api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/events/trigger
Trigger a notification event for one or more subscribers
/v1/events/trigger/broadcast
Broadcast a notification to all subscribers
/v1/events/trigger/bulk
Trigger multiple notification events in a single request
/v2/subscribers/{subscriberId}/preferences
Get subscriber notification preferences
/v2/topics
Create a notification topic for fan-out
/v1/subscribers/{subscriberId}/notifications/feed
Get a subscriber's notification feed
/v2/workflows
Create a notification workflow
/v1/integrations/active
List active notification provider integrations
/v1/events/trigger
Trigger a notification event for one or more subscribers
/v1/events/trigger/broadcast
Broadcast a notification to all subscribers
/v1/events/trigger/bulk
Trigger multiple notification events in a single request
/v2/subscribers/{subscriberId}/preferences
Get subscriber notification preferences
/v2/topics
Create a notification topic for fan-out
/v1/subscribers/{subscriberId}/notifications/feed
Get a subscriber's notification feed
/v2/workflows
Create a notification workflow
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Novu by hand means setting up its ApiKey Authorization header, choosing the right US or EU host (api.novu.co or eu.api.novu.co), and threading that through trigger, subscriber, and workflow calls yourself across more than a hundred endpoints. Through Jentic you install once, import the Novu API from the API Directory, store the key once, and your agent calls it.
Permission scoping
Novu triggers events from the request body rather than a resource id in the URL path, so scope the agent to the operations it needs, such as triggering an event and reading a subscriber feed. You choose that set, so creating workflows or topics is not included unless you add it.
Credential isolation
Your Novu API key is stored once, encrypted, by your own Jentic One instance and injected at execution time as the Authorization header. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'trigger a multi-channel notification' or 'read a subscriber feed', and Jentic returns the matching Novu operation with its input schema so the agent calls /v1/events/trigger without browsing the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using Novu API through Jentic.
Why is there no official OpenAPI spec for Novu API?
Novu does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Novu API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the Novu API use?
The Novu API uses API key authentication via the Authorization header with format 'ApiKey <your-secret-key>'. Through Jentic, your Novu API key is stored encrypted in your Jentic One instance and injected automatically, so agents never handle the raw secret key.
Can I send notifications to multiple channels with a single API call?
Yes. POST to /v1/events/trigger with your event name and subscriber ID. The notification routes through all channels defined in the associated workflow - email, SMS, push, in-app, and chat - based on the subscriber's active integrations and preferences.
What are the rate limits for the Novu API?
Novu enforces rate limits based on your plan tier. The trigger endpoint supports up to 300 events per second on the Business plan. Bulk trigger via POST /v1/events/trigger/bulk accepts up to 100 events per request for higher throughput. The API returns 429 with retry guidance when limits are hit.
How do I trigger a notification through Jentic with the Novu API?
Search for 'trigger a multi-channel notification' in Jentic to find the Novu events trigger endpoint. Load the operation schema, then execute with the event name, subscriberId, and payload object. Install with pip install jentic and use the search-load-execute flow. Jentic injects the ApiKey header automatically.
Does the Novu API support subscriber notification preferences?
Yes. GET /v2/subscribers/{subscriberId}/preferences returns per-workflow channel preferences. PATCH the same endpoint to update preferences. Novu respects these preferences at delivery time - if a subscriber opts out of email for a specific workflow, the notification skips the email step automatically.
Can I use topics for group notifications in Novu?
Yes. Create a topic via POST /v2/topics with a topicKey, then add subscribers via POST /v2/topics/{topicKey}/subscriptions. Trigger a notification to the topic and all subscribed members receive it. Topics support dynamic membership - add or remove subscribers at any time without modifying the trigger logic.
Can I limit what my agent is allowed to do with the Novu API?
Yes. Because you self-host Jentic One, your own rules decide which Novu operations and credentials the agent may use. Since Novu triggers events from the request body rather than a resource id in the URL path, you scope the agent to just the operations it needs, such as triggering an event with POST /v1/events/trigger and reading a subscriber feed with GET /v1/subscribers/{subscriberId}/notifications/feed. Anything you leave out, like creating workflows via POST /v2/workflows or topics via POST /v2/topics, stays off limits unless you add it.
Know of an official OpenAPI document? Contribute it →
For Agents
Trigger multi-channel notifications (email, SMS, push, in-app, chat), manage subscriber preferences, and orchestrate notification workflows from a single API.
Use for: I need to trigger a notification to a subscriber across multiple channels, Set up a notification workflow with email and in-app steps, List all subscribers who have unread notifications, I want to broadcast an announcement to all users
Not supported: Does not handle direct email composition, SMS routing, or push certificate management - use for notification orchestration and delivery coordination only.
Jentic publishes the only available OpenAPI specification for Novu API, keeping it validated and agent-ready. Orchestrate multi-channel notifications across email, SMS, push, in-app, and chat from a unified API with 102 endpoints. Define notification workflows with step-based logic, manage subscriber preferences, and route messages through configurable provider integrations. Supports topic-based fan-out, bulk subscriber operations, and per-subscriber channel credential management.
/v1/integrations/active
List active notification provider integrations