GET
/
v1
/
integrations
import { Novu } from '@novu/node';

const novu = new Novu('<NOVU_SECRET_KEY>');

await novu.integrations.getAll();


{
    _id: "_id",
    _environmentId: "_environmentId",
    _organizationId: "_organizationId",
    name: "name",
    identifier: "identifier",
    providerId: "providerId",
    channel: "channel",
    credentials: credentials,
    active: true,
    deleted: true,
    deletedAt: "deletedAt",
    deletedBy: "deletedBy",
    primary: true
}

Enter your API key in the Authorization field like the example shown below:

E.g ApiKey 18d2e625f05d80e

import { Novu } from '@novu/node';

const novu = new Novu('<NOVU_SECRET_KEY>');

await novu.integrations.getAll();


{
    _id: "_id",
    _environmentId: "_environmentId",
    _organizationId: "_organizationId",
    name: "name",
    identifier: "identifier",
    providerId: "providerId",
    channel: "channel",
    credentials: credentials,
    active: true,
    deleted: true,
    deletedAt: "deletedAt",
    deletedBy: "deletedBy",
    primary: true
}

Authorizations

Authorization
string
headerrequired

API key authentication. Allowed headers-- "Authorization: ApiKey <api_key>".

Response

200 - application/json
_id
string

The unique identifier of the integration record in the database. This is automatically generated.

_environmentId
string
required

The unique identifier for the environment associated with this integration. This links to the Environment collection.

_organizationId
string
required

The unique identifier for the organization that owns this integration. This links to the Organization collection.

name
string
required

The name of the integration, which is used to identify it in the user interface.

identifier
string
required

A unique string identifier for the integration, often used for API calls or internal references.

providerId
string
required

The identifier for the provider of the integration (e.g., "mailgun", "twilio").

channel
enum<string>
required

The channel type for the integration, which defines how the integration communicates (e.g., email, SMS).

Available options:
in_app,
email,
sms,
chat,
push
credentials
object
required

The credentials required for the integration to function, including API keys and other sensitive information.

active
boolean
required

Indicates whether the integration is currently active. An active integration will process events and messages.

deleted
boolean
required

Indicates whether the integration has been marked as deleted (soft delete).

deletedAt
string

The timestamp indicating when the integration was deleted. This is set when the integration is soft deleted.

deletedBy
string

The identifier of the user who performed the deletion of this integration. Useful for audit trails.

primary
boolean
required

Indicates whether this integration is marked as primary. A primary integration is often the default choice for processing.

conditions
object[]

An array of conditions associated with the integration that may influence its behavior or processing logic.

Was this page helpful?

Update workflow groupCreate integration