Bannerbear

Bannerbear in ZBrain Flow is a powerful platform that automates image generation with AI. It allows you to create dynamic, on-demand visuals from pre-defined templates, making it easy to generate personalized images for marketing campaigns, social media posts, or product listings—all without manual design work.

How to Integrate Bannerbear with ZBrain Flow

1. Click the “+” Button in the Flow Open your ZBrain Flow and select the plus sign (+) to add a new step.

2. Search for “Bannerbear” Type “Bannerbear” in the search bar to view the available tasks.

3. Choose the Desired Task Select the Create Image or Custom API Call action, depending on your workflow requirements.

Tasks You Can Perform on Bannerbear

• Create Image Generate a new image based on a Bannerbear template. You can map dynamic data (like text, images, or color values) from previous steps to populate template fields.

• Custom API Call Make a tailored API request to Bannerbear’s endpoints for more advanced use cases. This provides flexibility to access or modify Bannerbear data beyond the standard actions.

Create Image

Generate a new image based on a Bannerbear template. You can map dynamic data (like text, images, or color values) from previous steps to populate template fields.

How to Configure the “Create Image” Action with Bannerbear in ZBrain Flow?

Step 1: Add the “Create Image” Step

1. Insert a New Step

   • In your flow, click the + button to add a new step.

2. Search for “Bannerbear”

   • Type “Bannerbear” in the search bar and select Create Image from the available actions.

Step 2: Create a Bannerbear Connection

1. Under API Key, choose the Bannerbear connection or Create a new connection.

   • Name Your Connection

     • Enter a recognizable name (e.g., “Bannerbear”).

   • API Key

     • Paste your Bannerbear API Key, which you can obtain from your Bannerbear account.

   • Save the Connection

     • Click Save to finalize. Your new Bannerbear connection is now ready to use.

Step 3: Configure the “Create Image” Action

1. Template

   • Enter the Template ID from your Bannerbear dashboard. This corresponds to the specific template you want to use for image generation.

2. Template Version (Optional)

   • Specify which version of the template you’d like to render. If left blank, Bannerbear defaults to the latest version.

3. Transparent Background (Toggle)

   • Enable this if you need the generated image to have a transparent background.

4. Render or PDF (Toggle)

   • Switch between PNG or PDF output. If you need a PDF version, enable this toggle.

5. Metadata (Optional)

   • Provide additional metadata for advanced use cases. This can include custom fields or tracking information you want associated with the generated image.

Step 4: Save and Test

1. Save Your Configuration

   • Once you’ve specified all necessary details, click Save or Done to confirm.

2. Run the Flow

   • Test your flow to verify that the “Create Image” step communicates properly with Bannerbear.

3. Check the Output

   • Review the generated image link or PDF URL in the flow’s output to ensure the final design matches your expectations.

Custom API Call

Make a tailored API request to Bannerbear’s endpoints for more advanced use cases. This provides flexibility to access or modify Bannerbear data beyond the standard actions.

How to Configure the “Custom API Call” Action with Bannerbear in ZBrain Flow?

Step 1: Add the “Custom API Call” Step

1. Insert a New Step

   • In your ZBrain Flow, click the + button to add a new step.

2. Search for “Bannerbear”

   • Type “Bannerbear” in the search bar and select Custom API Call from the available options.

Step 2: Create a Bannerbear Connection

1. Under API Key, choose the Bannerbear connection or Create a new connection.

   • Name Your Connection

     • Enter a recognizable name (e.g., “Bannerbear”).

   • API Key

     • Paste your Bannerbear API Key, which you can obtain from your Bannerbear account.

   • Save the Connection

     • Click Save to finalize. Your new Bannerbear connection is now ready to use.

• Use the Existing Connection

If you’ve previously created a Bannerbear connection, you can select it directly in the API Key dropdown within the “Custom API Call” step.

Step 3: Configure the Request Details

1. URL

   • Enter the Bannerbear API endpoint you wish to call (e.g., https://sync.api.bannerbear.com/v2/images).

2. Method

   • Choose the HTTP method (e.g., GET, POST, PUT, DELETE) based on the Bannerbear endpoint you want to interact with.

3. Headers

   • The Authorization header (with your API key) will typically be added automatically once you select your Bannerbear connection.

   • Add any additional headers if required by the specific Bannerbear endpoint.

4. Query Parameters (Optional)

   • If the endpoint requires query parameters, click Add Item under Query Parameters and fill in the key-value pairs.

5. Body (Optional or Required)

   • Provide the JSON body in the Body field for POST or PUT requests.

   • Include fields like template, modifications, or other data as needed by the Bannerbear API documentation.

6. No Error on Failure (Toggle)

   • Enable this if you want the flow to continue even if the API call returns an error.

7. Timeout (in seconds) (Optional)

   • Specify how long the step should wait before timing out. If left blank, a default timeout is used.

Step 4. Save and Test

1. Save the Step

   • Once you’ve filled in the required details, click Save or Done to confirm.

2. Run the Flow

   • Test your flow to ensure the “Custom API Call” communicates correctly with Bannerbear.

3. Check the Output

   • Inspect the output to verify that the API call returned the expected result.

   • If the response doesn’t match your expectations, adjust the endpoint, request body, or headers as needed.