Contentdrips icon

Contentdrips

Create carousels and static graphics using the Contentdrips API
Join our community

Actions6

Overview

The node integrates with the Contentdrips API to create custom graphics and carousels based on user-defined templates. It supports both asynchronous job submission (where you get a job ID and check status later) and synchronous "1-click" generation that waits for the job to complete before returning the result.

This node is useful for automating the creation of social media content, marketing materials, or presentations where templated visuals need to be generated dynamically. For example, you can generate a carousel post with multiple slides customized via JSON or form inputs, or create a single graphic image with updated text and images.

Practical examples:

  • Automatically generate branded Instagram carousel posts from dynamic data.
  • Create PDF reports or PNG graphics with custom titles and images for marketing campaigns.
  • Poll job status until the rendering is complete and retrieve the final output in one workflow step.

Properties

Name Meaning
Template ID The ID of the template to use for rendering the graphic or carousel.
Output Format The format of the generated content: either PNG image or PDF document.
Wait Settings (Only for synchronous operations) Customize how often to poll for job completion and maximum wait time before giving up.
Include Branding Whether to include branding information such as name, handle, bio, website URL, and avatar image URL in the generated content.
Branding Collection of branding details including Name, Handle, Bio, Website URL, and Avatar Image URL. Only used if Include Branding is true.
Content Updates Input Choose how to provide content updates: via easy form input or advanced JSON array.
Content Updates (Form mode) Multiple content update entries specifying type (textbox or image), label (element identifier), and value (new content).
Content Updates JSON (JSON mode) Content updates as a JSON array of objects each with type, label, and value fields.
Carousel Input (For carousel operations) Choose how to provide carousel data: form input or JSON.
Intro Slide (Form mode) Heading, description, and image URL for the intro slide of the carousel.
Slides (Form mode) Multiple slides each with heading, description, and image URL.
Ending Slide (Form mode) Heading, description, and image URL for the ending slide of the carousel.
Carousel JSON (JSON mode) Complete carousel data including intro_slide, slides array, and ending_slide as a JSON object.
Job ID (For checking job status or retrieving results) The ID of the job to query.

Output

The node outputs JSON data representing the response from the Contentdrips API. Depending on the operation:

  • For asynchronous generation (generateGraphic or generateCarousel), it returns a job ID and initial job info.
  • For synchronous generation (generateGraphicSync or generateCarouselSync), it polls until the job completes and returns the final rendered content metadata.
  • For job status checks, it returns the current status of the job.
  • For job result retrieval, it returns the completed job's result data.

The actual rendered content (image or PDF) is typically provided as a URL or binary data reference within the returned JSON. If binary data is included, it represents the generated graphic or carousel file.

Dependencies

  • Requires an API key credential for authenticating with the Contentdrips API.
  • Uses internal helper functions to make HTTP requests to Contentdrips endpoints.
  • No additional external dependencies beyond the Contentdrips API and n8n environment.

Troubleshooting

  • Invalid JSON errors: When using JSON input modes for content updates or carousel data, malformed JSON will cause errors. Ensure JSON syntax is correct and matches expected structure.
  • No job ID returned: If the API does not return a job ID after starting a render job, the node throws an error. Verify the template ID and request parameters are valid.
  • Job timeout: Synchronous operations have configurable polling intervals and max wait times. If the job does not complete in time, a timeout error is thrown. Increase max wait time or check API service status.
  • API errors: Any failure reported by the Contentdrips API during job processing will be surfaced as node errors. Check the error message for details.
  • Missing required parameters: Template ID and job ID (for status/result operations) are mandatory. Omitting them causes errors.

Links and References

Discussion