Skip to main content

​
Installation

​
Node.js / TypeScript

npm install @novu/api
# or
pnpm add @novu/api
# or
yarn add @novu/api

​
Environment Variables

NOVU_SECRET_KEY=your-secret-key-here
Get your API key from dashboard.novu.co/api-keys.

​
Initialize the SDK

import { Novu } from "@novu/api";

const novu = new Novu({
  secretKey: process.env.NOVU_SECRET_KEY,
});

​
Python

pip install novu-py

import novu_py
from novu_py import Novu

with Novu(
    secret_key="YOUR_SECRET_KEY_HERE",
) as novu:

​
cURL

All API requests require the Authorization header: 
curl -X POST https://api.novu.co/v1/events/trigger \
  -H "Authorization: ApiKey YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "workflow-id",
    "to": "subscriber-id",
    "payload": {}
  }'
Note: In the REST API, the trigger field is called name (not workflowId). The SDK maps workflowId to name automatically.