Contentdrips

Create carousels and static graphics using the Contentdrips API

Actions4

Overview

The node integrates with the Contentdrips API to create visual content such as static graphics and multi-slide carousels from predefined templates. It supports generating images or PDFs based on user-supplied template IDs and customizable content updates. This node is useful for automating the creation of branded marketing materials, social media posts, or presentations without manual graphic design.

Typical use cases include:

  • Automatically generating social media carousel posts with multiple slides.
  • Creating single-image graphics customized with dynamic text or images.
  • Adding branding information like name, handle, bio, and avatar to generated content.
  • Checking the status of asynchronous rendering jobs and retrieving their results.

For example, a marketing team could use this node to generate weekly carousel posts by providing slide headings, descriptions, and images dynamically from a data source.

Properties

Name Meaning
Template ID The ID of the Contentdrips template to use for rendering the graphic or carousel. Required.
Output Format The format of the generated output. Options: PNG (image) or PDF. Default is PNG.
Include Branding Whether to include branding information in the output. Boolean flag.
Branding Collection of branding details included if "Include Branding" is true. Fields: Name, Handle (e.g., @username), Bio/tagline, Website URL, Avatar image URL.
Content Updates Multiple content updates to customize elements within the template. Each update specifies: Type (Text Box or Image), Label (element identifier in the template), and Value (new content).
Intro Slide For carousels only. Defines an optional intro slide with Heading, Description, and Image URL.
Slides For carousels only. Multiple slides can be added, each with Heading, Description, and Image URL.
Ending Slide For carousels only. Defines an optional ending slide with Heading, Description, and Image URL.
Job ID Used for operations checking job status or retrieving job results. The ID of the asynchronous job to query.

Output

The node outputs JSON data representing the response from the Contentdrips API for the requested operation:

  • For Generate Carousel and Generate Graphic operations, the output JSON contains details about the rendered content, including URLs or identifiers for the generated files in the specified format (PNG or PDF).
  • For Check Job Status, the output JSON provides the current status of the rendering job.
  • For Get Job Result, the output JSON includes the final result or download links once the job completes.

If the node generates binary data (images or PDFs), it is represented via URLs or references in the JSON output rather than raw binary data directly.

Dependencies

  • Requires an API key credential for authenticating with the Contentdrips API.
  • The node uses HTTP requests to the Contentdrips API endpoints /render, /render?tool=carousel-maker, /job/{jobId}/status, and /job/{jobId}/result.
  • No additional external dependencies beyond the Contentdrips API and n8n's HTTP request capabilities.

Troubleshooting

  • Common issues:

    • Invalid or missing Template ID will cause the API to reject the request.
    • Incorrect or expired API credentials will lead to authentication errors.
    • Providing incomplete or incorrectly labeled content updates may result in rendering failures or unexpected output.
    • Network connectivity problems can cause request timeouts or failures.

  • Error messages:

    • "Unknown operation: <operation>": Indicates an unsupported operation was selected; verify the operation parameter.
    • API error responses typically include descriptive messages; ensure all required parameters are correctly set.
    • If the node returns an error object in the output JSON, check the message for hints on fixing input data or credentials.

  • Resolution tips:

    • Double-check template IDs and content update labels against those defined in the Contentdrips editor.
    • Ensure the API key credential is valid and has necessary permissions.
    • Use the "Check Job Status" operation to monitor asynchronous rendering jobs.
    • Enable "Continue On Fail" in the node settings to handle partial failures gracefully.

Links and References

Discussion