Videomatik icon

Videomatik

Create and edit data in videomatik
Join our community

Actions5

Overview

This node interacts with the Videomatik API, specifically targeting the "Template" resource and its "Get Custom JSON" operation. It retrieves custom JSON data associated with a specific template in Videomatik. This is useful for scenarios where you need to programmatically access or process the customizable structure or metadata of a video templateā€”such as automating template management, integrating with other systems, or dynamically generating content based on template definitions.

Practical Example:
Suppose you have a workflow that needs to fetch the configuration or schema of a video template before creating personalized videos. You can use this node to retrieve the custom JSON for a given Template ID and then use that information in subsequent steps.

Properties

Name Type Meaning
Template ID String The unique identifier of the template whose custom JSON should be retrieved. (Required)

Output

The node outputs a json field containing the custom JSON data returned by the Videomatik API for the specified template. The exact structure of this output depends on the template's definition within Videomatik, but it typically includes fields describing the template's customizable elements, such as texts, images, shapes, colors, and possibly other metadata.

Example Output:

{
  "id": "template_123",
  "customJSON": {
    "texts": [...],
    "images": [...],
    "shapes": [...],
    "colors": [...]
    // ...other template-specific fields
  }
}

Note: If an error occurs and "Continue On Fail" is enabled, the output will include an error field with the error message.

Dependencies

  • External Service: Requires access to the Videomatik API.
  • API Credentials: Needs a configured videomatikApi credential in n8n.
  • n8n Configuration: Ensure the Videomatik node is installed and credentials are set up in your n8n instance.

Troubleshooting

Common Issues:

  • Invalid Template ID: If the provided Template ID does not exist, the API may return a "Not Found" error.
  • Missing Credentials: If the videomatikApi credential is not configured, authentication errors will occur.
  • Network/Connectivity Issues: Errors related to network timeouts or inability to reach the Videomatik API endpoint.

Error Messages:

  • "error": "Request failed with status code 404"
    Resolution: Check that the Template ID is correct and exists in your Videomatik account.

  • "error": "Authentication failed"
    Resolution: Verify that your Videomatik API credentials are correctly set up in n8n.

  • "error": "Network Error"
    Resolution: Ensure your n8n instance has internet access and can reach the Videomatik API.

Links and References

Discussion