Explore the docs ยป
Report Bug
ยท
Request Feature
ยท
Join Our Discord
ยท
Roadmap
ยท
X
ยท
Notifications Directory
Available in: Node.js ยท PHP ยท Go ยท Ruby ยท Kotlin ยท Elixir ยท Rust ยท Python ยท Java
Novu provides a unified API that makes it simple to send notifications through multiple channels, including In-App, Push, Email, SMS, and Chat. With Novu, you can create custom workflows and define conditions for each channel, ensuring that your notifications are delivered in the most effective way possible.
- ๐ Single API for all messaging providers (In-App, Email, SMS, Push, Chat)
- ๐ Easily manage notifications over multiple channels
- ๐ Equipped with a CMS for advanced layouts and design management
- ๐ก Built-in protection for missing variables (Coming Soon)
- ๐ฆ Easy to set up and integrate
- ๐ก Debug and analyze multi-channel messages in a single dashboard
- ๐ฆ Embeddable notification center with real-time updates
- ๐จโ๐ป Community-driven
- Getting Started
- GitOps & React Email Integration
- Embeddable notification center
- Providers
- Need Help?
- Links
- License
We are excited to launch the complete Novu API and admin panel. Do you want to give it a test before the official release? Here is how:
npx novu init
After setting up your account using the cloud or docker version, you can trigger the API using the @novu/node
package.
For API documentation and reference, please visit [Novu API Reference] (https://docs.novu.co/api-reference/events/trigger-event?utm_campaign=github-readme).
To get started with the Node.js package, you can install it using npm:
npm install @novu/node
import { Novu } from '@novu/node';
const novu = new Novu(process.env.NOVU_API_KEY);
await novu.trigger('<TRIGGER_NAME>', {
to: [
{
subscriberId: '<UNIQUE_IDENTIFIER>',
email: '[email protected]',
firstName: 'John',
lastName: 'Doe',
},
],
payload: {
name: 'Hello World',
organization: {
logo: 'https://happycorp.com/logo.png',
},
},
});
Create notification workflows right from your IDE and integrate with MJML/React Email/Maizzle and others
- Fully managed GitOps Flow, deployed from your CI
- Local Dev Studio to develop and debug workflows in your IDE
- React Email/Maizzle/MJML integrations
- Runs in your VPC
- Debug cloud triggers in your IDE
- Type safety with your favorite programming language
- Define workflow and step validations with Zod or JSON Schema
- Modify content and behavior via Web management input panel
client.workflow('comment-on-post', async ({step, subscriber}) => {
const inAppResponse = await step.inApp('in-app-step', async (inputs) => {
return {
// body: renderReactComponent(inputs)
};
}, {
inputs: {
// ...JSON Schema or ZOD/Ajv/Class Validators definition
}
});
// Novu Worker Engine will manage the state and durability of each step in isolation
const {digestedEvents} = await step.digest('1 day');
await step.email('email-step', async () => {
return {
subject: 'E-mail Subject',
body: renderReactEmail(<ReactEmailComponent events={digestedEvents} />);
}
}, {
// Step-level inputs defined in code and controlled in the novu Cloud UI by a Non-Technical Team member
inputs: {
// ...JSON Schema
},
providers: {
sendgrid: async (inputs) => {
// Echo runs as part of your application, so you have access to your database or resources
return {
to: email,
ipPoolName: 'custom-pool'
};
}
},
skip: () => {
// Write custom skip logic
return inAppResponse.seen || subscriber.isOnline;
}
});
// Define your workflow trigger payload using json schema and custom validation;
}, {
dataSchema: {
// ...JSON Schema
}
});
Using the Novu API and admin panel, you can easily add a real-time notification center to your web app without building it yourself. You can use our React / Vue / Angular components or an iframe embed, as well as a Web component.
![notification-center-912bb96e009fb3a69bafec23bcde00b0](https://user-images.githubusercontent.com/80174214/193887395-f1c95042-b4e6-480e-a89c-a78aa247fa90.gif)
Read more about how to add a notification center to your app with the Novu API here
Novu provides a single API to manage providers across multiple channels with a simple-to-use interface.
- Sendgrid
- Netcore
- Mailgun
- SES
- Postmark
- Custom SMTP
- Mailjet
- Mandrill
- SendinBlue
- MailerSend
- Infobip
- Resend
- SparkPost
- Outlook 365
- Twilio
- Plivo
- SNS
- Nexmo - Vonage
- Sms77
- Telnyx
- Termii
- Gupshup
- SMS Central
- Maqsam
- 46elks
- Clickatell
- Burst SMS
- Firetext
- Infobip
- Bandwidth
- RingCentral
- Novu
- MagicBell
- PagerDuty
Before you begin coding and collaborating, please read our Code of Conduct thoroughly to understand the standards (that you are required to adhere to) for community engagement. As part of our open-source community, we hold ourselves and other contributors to a high standard of communication. As a participant and contributor to this project, you agree to abide by our Code of Conduct.
We are more than happy to help you. If you are getting any errors or facing problems while working on this project, join our Discord server and ask for help. We are open to discussing anything related to the project.
Novu is licensed under the MIT License - see the LICENSE file for details.
Thanks a lot for spending your time helping Novu grow. Keep rocking ๐ฅ