How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Novu Notifications API

The Notifications API from Novu — 2 operation(s) for notifications.

Novu Notifications API is one of 20 APIs that Novu publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 26 JSON Schema definitions.

Tagged areas include Notification. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, a getting-started guide, and 26 JSON Schemas.

This API exposes 2 operations across 2 paths, and defines 31 schemas. It is described by OpenAPI 3.2.0, at version 3.15.0.

Requests are made against 2 base URLs: https://api.novu.co, https://eu.api.novu.co.

2 operations 2 paths 31 schemas 2 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.15.0
Base URL
https://api.novu.co
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Novu Notifications API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (secretKey). By default, every request must be authenticated.

  • secretKey — API key authentication. Allowed headers-- "Authorization: ApiKey ".

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 2 GET. Each is listed below with its method, path, parameters, and response codes.

Notifications 2
GET
/v1/notifications
Novu List All Events
NotificationsController_listNotifications 14 params → 200400401403404405409413
GET
/v1/notifications/{notificationId}
Novu Retrieve an Event
NotificationsController_getNotification 1 param → 200400401403404405409413

Schemas 31

The contract defines 31 schemas that model the data the API accepts and returns. The most detailed are ActivityNotificationResponseDto (21 properties), ActivityNotificationStepResponseDto (12 properties), ActivityNotificationJobResponseDto (11 properties), DigestMetadataDto (10 properties). Each schema is shown below with its type and property counts.

ActivityNotificationResponseDto
object
21 properties 4 required
ProvidersIdEnum
string
Provider ID of the job
ActivityNotificationJobResponseDto
object
11 properties 6 required
ActivityNotificationExecutionDetailResponseDto
object
9 properties 6 required
ActivityNotificationSubscriberResponseDto
object
6 properties 2 required
DigestTypeEnum
string
The Digest Type
FieldFilterPartDto
object
4 properties 4 required
ExecutionDetailsStatusEnum
string
Status of the execution detail
OrdinalEnum
string
Ordinal position for the digest
OrdinalValueEnum
string
Value of the ordinal
MonthlyTypeEnum
string
Type of monthly schedule
ExecutionDetailsSourceEnum
string
Source of the execution detail
DigestMetadataDto
object
10 properties 1 required
NotificationTriggerDto
object
4 properties 3 required
ErrorDto
object
6 properties 3 required
ResourceOriginEnum
string
Origin of the layout
ConstraintValidation
object
2 properties 1 required
BuilderFieldTypeEnum
string
ActivityTopicDto
object
2 properties 2 required
StepFilterDto
object
4 properties 4 required
ValidationErrorDto
object
7 properties 4 required
NotificationTriggerVariable
object
1 property 1 required
ChannelTypeEnum
string
Channel type through which the message is sent
ActivityNotificationTemplateResponseDto
object
4 properties 2 required
SeverityLevelEnum
string
Severity of the workflow
StepTypeEnum
string
Type of the step
MessageTemplateDto
object
DigestTimedConfigDto
object
8 properties
ActivitiesResponseDto
object
4 properties 4 required
DigestUnitEnum
string
Regular digest: Unit for backoff
ActivityNotificationStepResponseDto
object
12 properties 4 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

novu-notifications-api-openapi.yml Raw ↑

Other APIs Novu publishes across the network.

Novu Inbox / In-App API
Novu Framework (Code-First Workflows)
Novu MCP Server
Novu Activity API
Novu Channel Connections API
Novu Channel Endpoints API
Novu Contexts API
Novu Domains API
Novu Environment Variables API
Novu Environments API
Novu Events API
Novu Integrations API
Where this information came from

This is an independent, third-party profile of Novu Notifications API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.