Contentdrips

Create carousels and static graphics using the Contentdrips API

Actions4

Overview

This node integrates with the Contentdrips API to create visual content such as static graphics and multi-slide carousels based on predefined templates. It is useful for automating the generation of branded marketing materials, social media posts, or presentations by programmatically filling in template elements with dynamic content.

Typical use cases include:

  • Generating a single graphic image (PNG or PDF) from a template with customized text and images.
  • Creating multi-slide carousel posts with intro, multiple slides, and ending slides.
  • Optionally including branding information like name, handle, bio, website, and avatar.
  • Checking the status of asynchronous rendering jobs.
  • Retrieving results of completed rendering jobs.

For example, a social media manager could automate creating daily promotional graphics by specifying a template ID, updating text boxes and images dynamically, and optionally adding their brand info.

Properties

Name Meaning
Template ID The ID of the template to use for rendering the graphic or carousel. Required.
Output Format The format of the generated output. Options: PNG or PDF. Default is PNG.
Include Branding Whether to include branding information in the output. Boolean flag.
Branding Collection of branding fields (shown only if "Include Branding" is true):
- Name: Your name or brand name
- Handle: Your social media handle (e.g., @username)
- Bio: Your bio or tagline
- Website URL
- Avatar Image URL
Content Updates One or more updates to content elements in the template:
- Type: Element type to update (Text Box or Image)
- Label: Label of the element to update (set in Contentdrips editor)
- Value: New value for the element

Note: The above properties apply to both "Generate Graphic" and "Generate Carousel" operations.

Output

The node outputs JSON data representing the response from the Contentdrips API after performing the requested operation.

  • For Generate Graphic and Generate Carousel, the output JSON contains details about the rendered content, such as URLs or IDs referencing the generated files.
  • For Check Job Status, the output JSON provides the current status of a rendering job.
  • For Get Job Result, the output JSON includes the final result or download links of a completed job.

The node does not directly output binary data; instead, it returns metadata and URLs to access the generated graphics or carousels.

Dependencies

  • Requires an API key credential for authenticating with the Contentdrips API.
  • The node uses HTTP requests to communicate with the Contentdrips service endpoints.
  • No additional environment variables are required beyond the API authentication setup.

Troubleshooting

  • Common issues:

    • Invalid or missing Template ID will cause the API request to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Providing invalid labels in content updates that do not match the template's editable elements may cause errors or ignored updates.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Unknown operation": Occurs if an unsupported operation is specified; ensure the operation parameter is set correctly.
    • API error responses typically include descriptive messages; check the returned JSON error field for details.
    • If the node fails but "Continue On Fail" is enabled, errors are returned in the output JSON under an error property.

  • Resolution tips:

    • Verify all required parameters are provided and valid.
    • Confirm API credentials are correct and have necessary permissions.
    • Check the Contentdrips template configuration to ensure labels used in content updates exist.
    • Use the "Check Job Status" operation to monitor asynchronous rendering jobs.

Links and References

Discussion