← Tools Reference

Novu

Novu integration (Communication, Developer Tools). Imported from open-connector.

API key5 tools{api_base_url}
GET
novu_search_subscribers
Search Novu subscribers with filters and cursor pagination.

/v2/subscribers

10 parameters
ParamTypeRequiredDescription
afterstringoptionalCursor after which to fetch results.
beforestringoptionalCursor before which to fetch results.
limitintegeroptionalMaximum number of subscribers to return.
orderDirectionstringoptionalSort direction.
orderBystringoptionalField to order subscribers by.
includeCursorbooleanoptionalWhether to include the cursor item in the response.
emailstringoptionalEmail address to filter subscribers by.
namestringoptionalName to filter subscribers by.
phonestringoptionalPhone number to filter subscribers by.
subscriberIdstringoptionalSubscriber identifier to filter subscribers by.
POST
novu_create_subscriber
Create or upsert a Novu subscriber.

/v2/subscribers

11 parameters
ParamTypeRequiredDescription
subscriberIdstringrequiredUnique subscriber identifier from your system.
firstNamestringoptionalThe subscriber's first name.
lastNamestringoptionalThe subscriber's last name.
emailstringoptionalThe subscriber's email address.
phonestringoptionalThe subscriber's phone number.
avatarstringoptionalThe subscriber avatar URL or identifier.
localestringoptionalThe subscriber locale, such as en-US.
timezonestringoptionalThe subscriber timezone, such as America/New_York.
dataobjectoptionalCustom data stored with the Novu resource.
failIfExistsbooleanoptionalWhether Novu should fail if the subscriber already exists.
idempotencyKeystringoptionalOptional idempotency key sent with the request.
GET
novu_get_subscriber
Retrieve a Novu subscriber by subscriber ID.

/v2/subscribers/{subscriberId}

1 parameter
ParamTypeRequiredDescription
subscriberIdstringrequiredThe subscriber identifier from your system.
PATCH
novu_update_subscriber
Update a Novu subscriber by subscriber ID.

/v2/subscribers/{subscriberId}

10 parameters
ParamTypeRequiredDescription
subscriberIdstringrequiredThe subscriber identifier from your system.
firstNamestringoptionalThe subscriber's first name.
lastNamestringoptionalThe subscriber's last name.
emailstringoptionalThe subscriber's email address.
phonestringoptionalThe subscriber's phone number.
avatarstringoptionalThe subscriber avatar URL or identifier.
localestringoptionalThe subscriber locale, such as en-US.
timezonestringoptionalThe subscriber timezone, such as America/New_York.
dataobjectoptionalCustom data stored with the Novu resource.
idempotencyKeystringoptionalOptional idempotency key sent with the request.
POST
novu_trigger_event
Trigger a Novu workflow event for subscribers or topics.

/v1/events/trigger

9 parameters
ParamTypeRequiredDescription
namestringrequiredThe workflow trigger identifier.
tostringrequiredOne or more trigger recipients.
payloadobjectoptionalCustom data stored with the Novu resource.
overridesobjectoptionalProvider, channel, or step overrides for the trigger.
transactionIdstringoptionalUnique deduplication identifier for this trigger.
actorstringoptionalActor subscriber ID or actor object.
tenantstringoptionalA tenant ID or rich tenant object.
contextobjectoptionalContext objects keyed by context name.
idempotencyKeystringoptionalOptional idempotency key sent with the request.