Braze Content Blocks icon

Braze Content Blocks

Manage reusable content blocks for Braze email templates

Actions4

Create Content Block

AI-generated

Overview

This node manages reusable content blocks for Braze email templates. It allows users to create, retrieve, list, and update content blocks that can be reused across different email campaigns or templates within Braze. This is particularly useful for marketers and developers who want to maintain consistent content snippets (like headers, footers, disclaimers, or promotional banners) without duplicating them in every email.

Practical examples:

  • Creating a new content block for a seasonal promotion banner that can be inserted into multiple email templates.
  • Retrieving detailed information about an existing content block to review or audit its content.
  • Listing all content blocks filtered by modification date to find recently updated snippets.
  • Updating an existing content block to change its HTML content or tags without recreating it from scratch.

Properties

Name Meaning
Content Block Name Name for the content block; must be alphanumeric with dashes and underscores only.
Content The HTML or text content of the content block; maximum size is 50KB.
Description Optional description providing additional details about the content block.
State The state of the content block; can be either "Active" or "Draft".
Tags Comma-separated list of tags to categorize or label the content block.

Output

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

  • For Create Content Block, the output contains the newly created content block's details as returned by Braze.
  • For Get Content Block Info, the output includes detailed information about the specified content block, optionally including inclusion data.
  • For List Content Blocks, the output provides a list of content blocks, potentially filtered by modification dates, limit, and offset.
  • For Update Content Block, the output returns the updated content block's details.

If an error occurs during any operation, the output JSON will contain an error field describing the issue along with HTTP status code and Braze-specific error codes if available.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Braze API.
  • Needs the Braze instance URL or identifier to construct the correct API endpoint.
  • The node uses HTTP requests to communicate with Braze's REST API endpoints for content blocks management.

Troubleshooting

  • Common issues:

    • Invalid or missing API key credential will cause authentication failures.
    • Providing invalid content block names (non-alphanumeric or disallowed characters) may result in API errors.
    • Exceeding the content size limit (50KB) for the content block content will likely cause request rejection.
    • Incorrect or missing required parameters such as content block ID when updating or retrieving info will trigger errors.

  • Error messages:

    • Errors returned from Braze API are captured and surfaced in the node output under the error field.
    • HTTP status codes and Braze-specific error codes are included to help diagnose issues.
    • To resolve errors, verify credentials, ensure all required parameters are correctly set, and confirm content validity according to Braze API specifications.

Links and References

Discussion