On-brand variants
- Brief in plain English
- Persona applies brand rules
- Generates approved variants
33 tools available
Bannerbear offers an automated image and video generation API, allowing businesses to create graphics, social media visuals, and marketing collateral with customizable templates at scale
Connect Bannerbear to Definable to generate on-brand assets, refresh creative in bulk, render storyboards from briefs. Personas call Bannerbear's 33 tools directly from chat or scheduled flows. Hand it to a creative persona that knows your brand — the agent generates assets that ship.
Every Bannerbear action below is a callable tool any Definable persona can invoke.
Creates a new Bannerbear project with the specified name and optional settings. Use this tool to create new projects for organizing templates and API resources. Note: This action requires a Master API Key. Project-specific API keys cannot create new projects.
Tool to create a signed URL base for a template. Used for generating images via signed URLs. Signed bases enable on-demand image generation using encrypted URL parameters without requiring API calls for each image. Use when you need to create dynamic images through URL manipulation.
Create a new blank template in a Bannerbear project. Use when you need to programmatically create templates via API. Note: Templates can only be created via API if you have a Master API Key.
Tool to create a new template set by grouping multiple templates together. Use when you need to organize related templates into a single set for batch image generation. Template sets allow you to apply the same modifications to multiple templates simultaneously via a single API call.
Tool to create a new video template for video generation in Bannerbear. Video templates are based on existing image templates and hold additional rendering instructions for creating videos. Use when you need to set up a reusable template for generating videos with overlays, transcriptions, or multi-layer video compositions.
Create a project-level webhook that fires for all events of a specific type. Use this tool to register a URL that will receive POST requests when events occur in your Bannerbear project. Note: When using a Master API Key, you must provide a project_id parameter. Project API Keys do not require project_id.
Tool to delete a template referenced by its unique ID. Use when you need to permanently remove a template from a Bannerbear project. Note: This action requires a project_id when using a Master API Key.
Tool to delete a webhook referenced by its unique ID. Use when you need to remove a webhook that is no longer needed. Requires the webhook UID and project ID (when using Master API Key).
Retrieves Bannerbear account information including subscription plan, API usage, and quota limits. Use this tool to: - Check current API usage and remaining quota (resets monthly) - Verify the subscription plan - Get details about the current project Note: When using a Master API Key, you must provide a project_id parameter. Project API Keys do not require project_id.
Tool to retrieve a single Animated Gif object by its unique identifier (UID). Use when you need to check the status of a specific animated GIF, get its rendered URL, or retrieve detailed information about its configuration. The status field indicates the rendering progress: 'pending' (still processing), 'completed' (ready with image_url populated), or 'failed'. Poll this endpoint to monitor rendering progress, or use webhook_url for automatic notifications.
Verify API authentication and check which project the API key is scoped to. Use this to validate credentials before making other API calls or to confirm the project context.
This tool retrieves a list of all available fonts in Bannerbear. The fonts are categorized into Serif, Sans Serif, Novelty, International, and Custom, and can be used to verify font availability prior to creating or modifying images.
Retrieves a single Image object by its unique identifier (UID). Use this to check the status of an image generation request, retrieve the final image URL, or poll for completion. When using a Master API Key, you must provide the project_id parameter.
Retrieves detailed information about a specific Bannerbear project by its unique identifier (UID). Use this tool to get project details including name, creation date, template count, and feature settings.
Retrieve a single Screenshot object referenced by its unique ID. Use when you need to check the status or get the final screenshot URL for a previously created screenshot.
This tool retrieves a list of signed bases for a specific template. Signed bases are used to generate on-demand images using encrypted URL parameters. The endpoint returns a list of base URLs that can be used with the Signed URL feature.
Tool to retrieve a single template by its unique ID with layer defaults. Use when you need to get detailed information about a specific template including its dimensions, available modifications, and layer structure.
This tool retrieves detailed information about a specific template set using its unique identifier (UID). Template Sets are sets of Templates that you group together in the Bannerbear dashboard. It provides comprehensive details about the template set including its name, available modifications, and the list of templates inside the set.
Retrieves a single Webhook object by its unique ID. Use this to get details about a specific webhook including its URL, event type, and creation timestamp.
Hydrate a project by copying templates from another project. Useful for white-label setups where you need to duplicate templates across multiple projects. Both the source and destination projects must be under the same account.
Tool to import templates from the Bannerbear template library or from other projects. Use when you need to add publicly-available templates to your project. Note: Only publication IDs (public templates) can be imported, not private template IDs.
Merges multiple PDF files into a single combined PDF document. This tool accepts an array of publicly accessible PDF URLs and combines them in order into one merged PDF file. The operation is asynchronous - the response will initially have status 'pending' and you should poll the 'self' endpoint or use a webhook to get the final 'joined_pdf_url' when status becomes 'completed'. Note: When using a Master API Key (account-level key), you must provide the project_id parameter.
Lists all animated GIFs in a Bannerbear project. Retrieves a paginated list of all animated GIFs that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 animated GIFs per page by default, configurable up to 100 using the limit parameter.
Lists all collections in a Bannerbear project. Retrieves a paginated list of all collections that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 collections per page by default, configurable up to 100 using the limit parameter.
Tool to list all available image effects in Bannerbear. Use when you need to discover which effects can be applied to images or templates in the Bannerbear API.
Lists all images in a Bannerbear project. Retrieves a paginated list of all images that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 images per page by default, configurable up to 100 using the limit parameter.
Lists all projects in a Bannerbear account. This action retrieves a paginated list of all projects in your Bannerbear account. Use when you need to discover available projects or obtain project UIDs for other actions. Requires a Master API Key (not a project-specific API key).
Lists all screenshots in a Bannerbear project. Retrieves a paginated list of all screenshots that have been created in your Bannerbear project. When using a Master API Key, you must provide the project_id parameter. Returns up to 25 screenshots per page by default, configurable up to 100 using the limit parameter.
This action retrieves a list of all templates available in your Bannerbear project. It returns an array of template objects including properties like uid, name, dimensions, creation and update timestamps, template type, preview URL, and modifications. The tool is used for listing templates, retrieving template UIDs for subsequent actions such as image or video creation, and managing project templates.
Tool to list all template sets inside a project with pagination support. Template Sets are groups of Templates that you organize in the Bannerbear dashboard. Use when you need to retrieve all template sets or paginate through them.
This action retrieves a list of all videos created in your Bannerbear account. It returns an array of video objects including properties like uid, status, timestamps, video and preview URLs, as well as template and modification details. The tool is used for listing videos, monitoring video status, and managing project videos.
This action retrieves a list of all video templates available in your Bannerbear project. It returns an array of video template objects including properties like uid, name, dimensions, and creation timestamps. The tool is used for listing video templates and retrieving template UIDs for subsequent video creation actions.
Tool to update a template set by modifying its list of templates. The template set will be cleared first and the new list applied. Use when you need to change which templates are included in a template set. Template Sets are sets of Templates that you group together in the Bannerbear dashboard.
Anything Bannerbear exposes through its API. Common images & design workflows on Definable include generate on-brand assets, refresh creative in bulk, render storyboards from briefs. Personas can call any of the 33 Bannerbear tools directly, then chain the result into another integration without you writing code.
Bannerbear uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Yes — every Definable plan, including Starter, includes access to all 33 Bannerbear tools. You only need a separate Bannerbear subscription if Bannerbear itself charges per seat or per API call.
Every call from a persona to Bannerbear is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
Sign up for Definable, open the integrations page, find Bannerbear, and connect via OAuth or API key. You can immediately attach Bannerbear to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
Definable exposes all 33 Bannerbear actions as callable tools — including `Create Project`, `Create Signed Base`, `Create Template`, plus 30 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Wire it up in minutes. No coding required.