N8N
JSON2Video can be easily integrated with n8n, a free and open-source workflow automation tool. This allows you to automate video creation as part of larger workflows involving various other applications and services.
This section provides a guide to using JSON2Video within n8n.
Submit a JSON2Video rendering job
To use JSON2Video in n8n, you will need to create an HTTP Request node configured to interact with the JSON2Video API.
Here's a step-by-step guide:
-
Add an HTTP Request node: In your n8n workflow, add a new "HTTP Request" node.
-
Configure the HTTP Request node:
- Method: Set the method to
POST
to create a new movie. - URL: Set the URL to
https://api.json2video.com/v2/movies
. - Headers: Enable the "Send Headers" button:
- Specify Headers: Using Fields Below
- Header Parameters:
- Name:
x-api-key
- Value:
YOUR_API_KEY
(ReplaceYOUR_API_KEY
with your actual JSON2Video API key. See the Getting Started section for how to obtain your API key).
- Name:
- Body: Enable the "Send Body" button:
- Body Content Type: JSON
- Specify Body: Using JSON
- JSON: Paste your JSON here
- Method: Set the method to
Check the screenshot below to confirm the settings:
- Execute the node: Execute the HTTP Request node. If successful, it will return a JSON response containing the project ID like this:
{ "success": true, "project": "WAEE8PohgVwv2teP", "timestamp": "2025-05-28T14:57:34.393Z" }
You must use the project ID (in the example above the project ID is WAEE8PohgVwv2teP
) to check the project status.
Prepare the JSON payload
You will need to create a JSON payload according to the JSON Syntax. This payload defines the movie
object, including the scenes
and elements
required for video creation. You can use n8n's expression editor to dynamically generate this JSON based on data from previous nodes in your workflow.
Example JSON Payload:
{
"comment": "My n8n generated video",
"resolution": "full-hd",
"scenes": [
{
"elements": [
{
"type": "text",
"text": "Hello from n8n!",
"duration": 5
}
]
}
]
}
Check Movie Status
To check the status of the movie rendering, you'll need a second HTTP Request Node.
The video rendering can take several minutes to render the video depending on the complexity of the video and its length.
Configure this node as follows:
- Method:
GET
- URL: Construct the URL using n8n's expression editor to include the
project
query parameter:https://api.json2video.com/v2/movies?project={{$node["YOUR_FIRST_HTTP_REQUEST_NODE_NAME"].json.project}}
(ReplaceYOUR_FIRST_HTTP_REQUEST_NODE_NAME
with the name of the first node). - Headers: Same as the first HTTP Request node.
You can then parse the response from the second HTTP Request Node to determine the status of the video and retrieve the final video URL. The Movie object in the response will contain the URL.
Remember to consult the API Reference for details on all possible parameters and configurations.
You will likely need to experiment with the exact settings and expressions within n8n to achieve your desired video automation workflow.