Migrate from Courier to Novu

​

Why Novu?

• Unified Workflows: Courier separates “Templates” (content) and “Automations” (logic). Novu unifies routing, timing (delays/digests), and content into a single Workflow, making it much easier to manage the entire lifecycle of a message.
• Choose How You Build:
  • Visual Builder: A powerful drag-and-drop dashboard for teams that want a no-code UI to design content and orchestration.
  • Novu Framework: An optional code-first approach that lets developers write workflows in TypeScript, version-control them, and test them locally.
• Unrivaled React Ecosystem: Novu’s in-app Inbox comes with pre-built React components for a drop-in experience, plus powerful headless hooks if you want to build a completely bespoke UI.
• Data Sovereignty: Because Novu is open-source, you can use our fully managed Cloud platform or self-host it on your own infrastructure to meet strict compliance requirements.
• Translations: Novu supports translations for your notifications, making it easier to localize your notifications for your users. Use translation keys in channel step editor to localize your notifications and Novu will send the notifications in the subscriber’s locale. Read more on how to use translations in the Novu Dashboard.
• Multi-tenancy: Send notifications to different tenants or organizations within the same Novu project and let users manage their notification preferences for each tenant. Read more on how to use multitenancy in the Novu Dashboard.

​

Mapping Courier concepts to Novu concepts

​

Migration steps

const novu = new Novu({ secretKey: 'YOUR_NOVU_API_KEY' });

// Translating a Courier profile to a Novu subscriber
await novu.subscribers.create({
  subscriberId: 'usr_123', // Your internal user ID
  email: '[email protected]',
  phone: '+15551234567',
  data: {
    subscriptionTier: 'premium' // Custom data
  }
});

export const weeklyDigestWorkflow = workflow('weekly-digest', async ({ step }) => {
  // Replaces Courier's digest node
  const digestResult = await step.digest('batch-events', () => ({ amount: 7, unit: 'days' }));

  // Replaces Courier's send node + template
  await step.email('send-summary', async (controls) => {
    return {
      subject: `Your Weekly Activity Summary`,
      body: `You have ${digestResult.events.length} new updates this week.`,
    };
  });
});

npm install @novu/react

export default function NotificationCenter() {
  return (
    <Inbox
      applicationIdentifier="YOUR_NOVU_APP_ID"
      subscriberId="usr_123"
      // We recommend using HMAC encryption in production for security
      subscriberHash="HMAC_HASH_GENERATED_ON_BACKEND" 
    />
  );
}

const novu = new Novu({ secretKey: 'YOUR_SECRET_KEY' });

// Replaces courier.send()
await novu.trigger({
  workflowId: 'weekly-digest',
  to: { 
    subscriberId: 'usr_123',
    // Pass details inline for easy lazy migration
    email: '[email protected]' 
  },
  payload: {
    activityType: 'login'
  }
});

import novu_py
from novu_py import Novu
import os
 
with Novu(
secret_key=os.getenv("NOVU_SECRET_KEY", ""),
) as novu:
 
    res = novu.trigger(trigger_event_request_dto=novu_py.TriggerEventRequestDto(
        workflow_id="workflow_identifier",
        to={
            "subscriber_id": "subscriber_unique_identifier",
            "first_name": "Albert",
            "last_name": "Einstein",
            "email": "[email protected]",
        },
        payload={
            "comment_id": "string",
            "post": {
                "text": "string",
            },
        },
        overrides={
          "email": {
            "bcc": "[email protected]"
          }
        },
    ))
 
    # Handle response
    print(res)

curl -X POST https://api.novu.co/v1/events/trigger \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "weekly-digest",
    "to": { "subscriberId": "usr_123" },
    "payload": {
      "activityType": "login"
    }
  }'

​

API endpoint quick reference

​

Next steps