Actions6
Overview
This node integrates with the Contentdrips API to create custom graphics and carousels based on user-defined templates. It supports both asynchronous job-based generation (where a job ID is returned for later status checking) and synchronous "1-click" generation that waits for the final output automatically.
Typical use cases include:
- Automatically generating social media graphics or marketing materials from predefined templates.
- Creating multi-slide carousel posts with dynamic content updates.
- Embedding branding information such as name, handle, bio, and avatar into generated content.
- Automating design workflows where manual graphic creation would be time-consuming.
For example, a marketer could use this node to generate a promotional image by specifying a template ID, updating text and images dynamically, and receiving a PNG or PDF output ready for publishing.
Properties
| Name | Meaning |
|---|---|
| Template ID | The identifier of the template to use for rendering the graphic or carousel. Required. |
| Output Format | The format of the generated content. Options: PNG, PDF. |
| Wait Settings | (Only for synchronous operations) Controls polling behavior: how often to check if the content is ready (seconds), and maximum wait time before giving up (minutes). |
| Include Branding | Whether to include branding information in the generated content. Boolean. |
| Branding | If branding is included, allows specifying: Name, Social Media Handle, Bio/Tagline, Website URL, and Avatar Image URL. |
| Content Updates Input | Choose how to provide content updates: Use Form (Easy) or Use JSON (Advanced). |
| Content Updates | When using form input mode, specify one or more content updates, each with: Type (Text Box or Image), Label (element label in the template), and Value (new content). |
| Content Updates JSON | When using JSON input mode, provide an array of content update objects, each with type, label, and value fields. |
Output
The node outputs JSON data representing either:
- A job object containing a job ID when starting an asynchronous generation job.
- The final rendered result when using synchronous generation or fetching job results/status.
The JSON structure varies depending on the operation but generally includes:
- Job status information (
status,message). - Result URLs or binary data references for the generated graphic/carousel.
- Error messages if the job failed or timed out.
Binary data is not directly output by the node; instead, URLs or references to the generated files are provided.
Dependencies
- Requires an API key credential for authenticating with the Contentdrips API.
- Network access to the Contentdrips API endpoints.
- No additional external dependencies beyond the n8n environment and the configured API credential.
Troubleshooting
- Invalid Content Updates JSON: If the JSON provided for content updates or carousel data is malformed or not an array/object as expected, the node will throw an error indicating invalid JSON. Ensure the JSON syntax is correct and matches the expected schema.
- No job ID returned from API: This error occurs if the API response does not include a job identifier after requesting a render. Verify that the template ID and other parameters are valid and that the API service is functioning correctly.
- Job timeout: When using synchronous generation, if the job does not complete within the specified maximum wait time, the node throws a timeout error. Increase the wait time or check the API service status.
- Job failed: If the job status returns as failed or error, the node surfaces the message from the API. Check the template configuration and content updates for correctness.
- Unknown operation: If an unsupported operation value is set, the node will throw an error. Use only the documented operations.
Links and References
- Contentdrips API Documentation (example link, replace with actual)
- n8n Documentation on Creating Custom Nodes
- JSON validation tools for verifying content updates and carousel JSON inputs