Videomatik icon

Videomatik

Create and edit data in videomatik
Join our community

Actions5

Overview

The Videomatik node for n8n allows you to create a new video request using a specified template, with customizable compositions, texts, images, shapes, colors, soundtrack, and actions. This is particularly useful for automating the generation of personalized or dynamic videos based on user input or workflow data.

Common scenarios:

  • Automating marketing video creation with custom branding and content.
  • Generating social media videos (e.g., feed or stories format) from form submissions or CRM data.
  • Creating templated product showcase videos with dynamic text, images, and styles.

Practical example:
A marketing team could use this node to automatically generate Instagram story videos for each new product added to their database, customizing the text, images, and color scheme per product.

Properties

Name Type Meaning
Template String The target template to create the video request.
Composition ID Options The video resolution/composition type (e.g., Feed, Stories).
Texts Fixed Collection List of text elements to include in the video, each with path, font, style, value, etc.
Images Fixed Collection List of image elements to include, each with a path and optional source.
Shapes Fixed Collection List of shape elements to include, each with a path and color.
Send Soundtrack Boolean Whether to include a soundtrack in the video.
Soundtrack String The soundtrack to be used if "Send Soundtrack" is enabled.
Send Colors Boolean Whether to include custom colors in the video.
Colors Fixed Collection List of color settings, each with path, color, effect name, and effect layer name.
Custom JSON JSON Raw custom JSON to define the video request (overrides other fields if enabled).
Send Custom Data as Json Boolean If true, sends the custom JSON instead of individual fields.
Send Custom Actions Boolean Whether to include custom actions in the video.
Actions Fixed Collection List of action objects, each with type and URL, to be included if "Send Custom Actions" is enabled.

Output

  • The node outputs a json object containing the response from the Videomatik API after creating the video request.
  • The structure of the output will depend on the API's response, but typically includes details about the created video request (such as IDs, status, and any errors).
  • If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Example output (success):

{
  "id": "12345",
  "status": "created",
  "videoUrl": "https://example.com/video.mp4",
  ...
}

Example output (error, with Continue On Fail):

{
  "error": "Invalid templateId"
}

Dependencies

  • External Service: Requires access to the Videomatik API.
  • API Key: You must configure valid Videomatik API credentials in n8n under the name videomatikApi.
  • n8n Configuration: No additional environment variables are required beyond standard credential setup.

Troubleshooting

Common issues:

  • Missing or invalid credentials: Ensure that the Videomatik API key is correctly configured in n8n.
  • Invalid template or composition ID: Double-check that the provided template and composition IDs exist and are correct.
  • Malformed custom JSON: If using the "Custom JSON" property, ensure the JSON is valid and matches the expected schema.
  • Required fields missing: Make sure all required properties (like texts, images, shapes) are provided unless using custom JSON.

Error messages:

  • "Invalid templateId": The specified template does not exist or is not accessible. Check your template selection.
  • "Missing required property": One or more required fields were not provided. Review the node configuration.
  • "Authentication failed": The API credentials are incorrect or expired. Update your credentials in n8n.

Links and References

Discussion