Description

n8n-nodes-klap

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

Klap is an AI video editor that turns long videos into viral short clips with captions and reframing for TikTok, Reels and YouTube Shorts. With this node you can clip videos, get the clips Klap found, render them to MP4, write captions and schedule posts, all from a workflow.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Example workflows
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation. The package name is n8n-nodes-klap.

Operations

A project is one long video you clipped; its clips are the short videos Klap made from it.

Klap node

| Resource | Operation | What it does |
|—|—|—|
| Project | Create | Clip a video: from a link (YouTube, Google Drive, Dropbox, Vimeo, Twitch, Loom or a direct link to a video file) or from a binary file (MP4, MOV or WebM, uploaded for you). Options: max number of clips, clip length, aspect ratio, language, instructions (“the funniest moments”), project name. Waits until the clips are ready (Wait for Clips, on by default), then outputs one item per clip, best first, each with a preview_url to watch or embed it. Turn Wait for Clips off to get the project right away with status processing. |
| Project | Get | A project and, once it is ready, its clips (best first). |
| Project | Get Many | Your most recent projects, newest first (up to 50). |
| Clip | Get Many | The clips of a ready project, best first, with an optional minimum virality score. |
| Clip | Export | Renders a clip to MP4 and waits until it is ready (10 minutes by default; you can turn waiting off). Can add the MP4 to the output as binary data. |
| Clip | Schedule | Posts a clip to one or more connected social accounts (YouTube, TikTok, Instagram, Facebook, LinkedIn), now or at a set time. Leave the caption empty and Klap writes one. Outputs one item per post. |
| Clip | Write Caption | Writes a social media caption for a clip with AI, in the tone you choose. |
| Export | Get | Status and video URL of an export started earlier. |
| Social Account | Get Many | The social accounts connected to your Klap account. |

Projects, clips and social accounts can be picked from a list or set by ID (clips also by their https://klap.app/editor/… URL).

Klap Trigger node (polling)

| Event | Fires |
|—|—|
| Project Ready | Once per project when it finishes, with all its clips (best first). |
| New Clip | Once per clip of newly ready projects. Options: Minimum Virality Score and Only the Best N Clips per Project. Looks at your 10 most recent ready projects. |
| Project Failed | Once per project Klap couldn’t clip, with the reason in error_message. |

When you activate a workflow, the trigger only remembers what already exists: it never fires for past projects. When you test it in the editor, it returns your most recent real item.

Output fields

Every operation returns the same field names as Klap’s Zapier and Make apps:

• Project: id, name, status (processing, ready, error or expired), errorcode, errormessage, sourceurl, thumbnailurl, createdat, estimatedreadyat, url, and when fetched clipcount and clips.
• Clip: id, name, viralityscore (0–100), viralityscoreexplanation, durationseconds, width, height, thumbnailurl, previewurl, editorurl, createdat, rank (1 = best of its project), projectid, projectname, project_url.
• Export: id, clipid, status, videourl (a public MP4 link once ready), filename, estimatedreadyat, createdat, finished_at.
• Scheduled post: id, clipid, accountid, provider, accountname, scheduledat, status, calendar_url.

Credentials

You connect with your Klap account. There is no API key, client ID or client secret to copy.

1. Sign up at klap.app if you don’t have an account.
2. In n8n, create a Klap OAuth2 API credential and click Connect my account.
3. Sign in to Klap and allow access for n8n.

What you do with the node counts toward your Klap plan, as on klap.app: clipping uses your video allowance, exports your export allowance, and scheduling needs a plan that includes it. See klap.app/pricing.

How it works: Klap uses OAuth 2.1 with PKCE. n8n registers itself with Klap’s authorization server automatically (OAuth dynamic client registration) the first time you connect, so the same credential works on n8n Cloud and on any self-hosted instance. n8n refreshes the access token on its own; if it ever can’t, the node says “Your Klap connection expired. Reconnect your Klap account.” Open the credential and click Reconnect.

Self-hosted: n8n sends Klap its OAuth callback URL (/rest/oauth2-credential/callback). Make sure your instance’s public URL is set (N8NEDITORBASEURL or WEBHOOKURL) so that URL is right.

Compatibility

• Requires n8n 2.12.0 or later: the credential relies on n8n’s OAuth dynamic client registration with protected resource (RFC 9728) and path-aware authorization server (RFC 8414) discovery, added in n8n 2.12.0. From n8n 2.28.0, n8n requests exactly the scopes Klap’s API advertises (openid email profile); 2.12 to 2.27 request every scope Klap’s authorization server lists.
• Built and type-checked against n8n-workflow 2.42. No runtime dependencies.
• Works on n8n Cloud. Long exports wait inside the execution, so on plans with a short execution time limit, turn off Wait for Export and use Export → Get later, or the Klap Trigger.

Usage

• Clipping takes several minutes, usually 5 to 15. Project → Create waits for the clips by default, up to Timeout (Minutes) (60 by default), and the execution keeps running meanwhile. On n8n plans with a short execution time limit, turn Wait for Clips off and act on the clips with the Klap Trigger (Project Ready or New Clip) or Project → Get instead. Workflows built with version 0.1 keep returning the project right away.
• Exports: Clip → Export renders the clip (about as long as the clip itself) and waits for it. videourl is a public link you can pass to other nodes; turn on Download Video to get the MP4 as binary data (for Google Drive, Dropbox, S3 and so on). Exports count toward your plan’s export allowance, so export a clip once and reuse its videourl.
• Scheduling: connect your social accounts in Klap first, at klap.app/calendar. Leave Publish At empty to post within a couple of minutes. Times without an offset are read in the Time Zone you set (UTC by default); values with an offset, such as {{ $now.plus(1, 'day') }}, are used as they are. A clip can go to one account per platform at a time. Posting to TikTok needs TikTok Privacy (under Additional Fields). Review or change posts at klap.app/calendar.
• Errors tell you what to do: for example “This isn’t included in your current Klap plan (available on the Pro plan). See plans at https://klap.app/pricing.” or “This YouTube video is age-restricted.” Turn on Continue On Fail to keep going and get the message in an error field.
• New to n8n? See Try it out.

Example workflows

1. Clip a video from a form and show the clips. n8n Form Trigger (a Video URL field) → Klap (Project → Create, Video URL {{ $json['Video URL'] }}) → n8n Form (Form Ending, Show Text) listing each clip’s previewurl with {{ $input.all().map(c => c.json.previewurl).join('
') }}. Whoever fills in the form sees their clips on the same page a few minutes later. Add Klap (Clip → Export) before the last step for MP4 files.

2. Post the best clip of every new project to YouTube Shorts. Klap Trigger (New Clip, Only the Best N Clips per Project = 1, Minimum Virality Score = 70) → Klap (Clip → Schedule, Clip ID {{ $json.id }}, your YouTube account, caption left empty so Klap writes one).

Copy this JSON and paste it into an n8n workflow, then pick your Klap credential and social account:

{
  "name": "Klap: post the best clip of each new project",
  "nodes": [
    {
      "parameters": {
        "pollTimes": { "item": [{ "mode": "everyX", "value": 5, "unit": "minutes" }] },
        "event": "newClip",
        "options": { "minViralityScore": 70, "clipsPerProject": 1 }
      },
      "name": "Klap Trigger",
      "type": "n8n-nodes-klap.klapTrigger",
      "typeVersion": 1,
      "position": [0, 0]
    },
    {
      "parameters": {
        "resource": "clip",
        "operation": "schedule",
        "clipId": { "__rl": true, "mode": "id", "value": "={{ $json.id }}" },
        "accountIds": [],
        "additionalFields": {}
      },
      "name": "Schedule the clip",
      "type": "n8n-nodes-klap.klap",
      "typeVersion": 1,
      "position": [260, 0]
    }
  ],
  "connections": {
    "Klap Trigger": { "main": [[{ "node": "Schedule the clip", "type": "main", "index": 0 }]] }
  }
}

3. Clip every video added to a Google Drive folder. Google Drive Trigger (File Created in a folder) → Google Drive (Download) → Klap (Project → Create, Video Source Binary File, Input Binary Field data). Or skip the download and pass the file’s share link as Video URL.

4. Back up every good clip to Dropbox. Klap Trigger (New Clip, Minimum Virality Score = 80) → Klap (Clip → Export, Clip ID {{ $json.id }}, Download Video on) → Dropbox (Upload, binary field data, file name {{ $json.file_name }}).

5. Clip each new YouTube upload. RSS Feed Trigger (https://www.youtube.com/feeds/videos.xml?channel_id=) → Klap (Project → Create, Video URL {{ $json.link }}, Instructions “the most quotable moments”).

Resources

• n8n community nodes documentation
• Klap · Pricing · Privacy policy · Terms
• Support: support@klap.app

Version history

• 0.2.0: Project → Create waits for the clips and outputs one item per clip (Wait for Clips, on by default in node version 1.1), with Timeout (Minutes).
• 0.1.1, 0.1.2: published with npm provenance; author email team@klap.app.
• 0.1.0: first release. Klap node (Project, Clip, Export, Social Account), Klap Trigger (Project Ready, New Clip, Project Failed) and the Klap OAuth2 API credential.