n8n-nodes-ngram

Official Ngram community node for n8n. Generate AI videos, look up their status, and react to completion events from n8n workflows.

This is an n8n community node. It lets you use Ngram in your n8n workflows.

Features

• Action - Create Video: start an Ngram video render from any workflow.
• Action - Get Status: check a submitted job by id.
• Trigger - On Video Ready: receive video.completed webhook events.
• Trigger - On Video Failed: receive video.failed webhook events.

Installation

Follow the n8n community node installation guide.

Self-hosted n8n

1. Open Settings > Community nodes > Install.
2. Enter n8n-nodes-ngram and confirm.
3. Restart n8n. The Ngram nodes appear in the node picker.

Docker or CLI

docker exec -u node <your-n8n-container> sh -c "
  cd /home/node/.n8n/nodes
  npm install n8n-nodes-ngram
"
docker restart <your-n8n-container>

If the package is still on the beta dist-tag, install n8n-nodes-ngram@beta instead.

n8n Cloud

n8n Cloud support is available after the node is verified through the n8n Creator Portal. Until verification is complete, Cloud users can use the Make or Zapier integrations.

Credentials

1. Generate an API key at ngram.com/app/settings/api-keys. The key starts with ngs_.
2. In n8n, create a new Ngram API credential and paste the key.
3. Leave Base URL as https://www.ngram.com for production. Override it only for staging or preview environments.

Use the credential Test button to verify access. It calls GET /api/v1/account.

Operations

Ngram node

| Operation | Required inputs | Returns | | --- | --- | --- | | Create Video | prompt | Job descriptor including id and status | | Get Status | id returned by Create Video | Current status and output URLs when ready |

Trigger nodes

| Trigger | Event subscribed | Payload | | --- | --- | --- | | Ngram: On Video Ready | video.completed | Video metadata and signed download URLs | | Ngram: On Video Failed | video.failed | Job id and failure reason |

Trigger Behavior

The trigger nodes register a webhook subscription with the Ngram API when activated and delete it when deactivated. On re-activation, they query GET /api/v1/webhooks/subscriptions and reuse any matching subscription instead of creating a duplicate.

When a trigger is deleted, it also sweeps residual orphan subscriptions for the same (event_type, target_url) pair.

HMAC Signature Verification

Webhook payloads are HMAC-signed with X-Ngram-Signature and X-Ngram-Timestamp headers.

This version of the node does not surface the signing secret for inline verification inside n8n. The secret is returned only at subscription creation time and is not exposed by the list endpoint. If you need signature verification, chain an HTTP Request or Function node downstream and validate the headers against your stored secret.

Compatibility

• n8n: >= 1.82.0
• Node.js: >= 24

Usage

A ready-to-use workflow is included at templates/notify-on-video-ready.json. Import it with Workflow menu > Import from file, replace the credential reference and Slack channel, then activate the workflow.

The template uses only the On Video Ready trigger. Ngram's public API does not currently expose a per-workflow correlation id, so a template that chains Create Video with the trigger would fire for every video on the account. For a correlated create-and-wait flow, chain Create Video with a Wait node followed by a Get Status loop.

Resources

• Ngram documentation
• Ngram public API reference
• n8n community nodes documentation
• n8n community node verification guidelines

Contributing

This package is source-mirrored from the Ngram monorepo, where primary development happens. Pull requests and issues filed here are welcome and will be reviewed for upstream inclusion.

See CONTRIBUTING.md for details.

License

MIT - Copyright (c) 2026 Ngram.