# Bannerbear

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

- **Category:** images & design
- **Auth:** API_KEY
- **Tools:** 33
- **Triggers:** 0
- **Slug:** `BANNERBEAR`
- **Version:** 20260217_00

## Tools

### Create Project

**Slug:** `BANNERBEAR_CREATE_PROJECT`

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.

### Create Signed Base

**Slug:** `BANNERBEAR_CREATE_SIGNED_BASE`

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 Template

**Slug:** `BANNERBEAR_CREATE_TEMPLATE`

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.

### Create Template Set

**Slug:** `BANNERBEAR_CREATE_TEMPLATE_SET`

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.

### Create Video Template

**Slug:** `BANNERBEAR_CREATE_VIDEO_TEMPLATE`

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 Webhook

**Slug:** `BANNERBEAR_CREATE_WEBHOOK`

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.

### Delete Template

**Slug:** `BANNERBEAR_DELETE_TEMPLATE`

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.

### Delete Webhook

**Slug:** `BANNERBEAR_DELETE_WEBHOOK`

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).

### Get Account Info

**Slug:** `BANNERBEAR_GET_ACCOUNT_INFO`

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.

### Get Animated GIF

**Slug:** `BANNERBEAR_GET_ANIMATED_GIF`

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.

### Get Auth Status

**Slug:** `BANNERBEAR_GET_AUTH`

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.

### Get Available Fonts

**Slug:** `BANNERBEAR_GET_FONTS`

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.

### Get Image

**Slug:** `BANNERBEAR_GET_IMAGE`

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.

### Get Project

**Slug:** `BANNERBEAR_GET_PROJECT`

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.

### Get Screenshot

**Slug:** `BANNERBEAR_GET_SCREENSHOT`

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.

### Get Signed Bases

**Slug:** `BANNERBEAR_GET_SIGNED_BASES`

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.

### Get Template

**Slug:** `BANNERBEAR_GET_TEMPLATE`

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.

### Get Template Set Details

**Slug:** `BANNERBEAR_GET_TEMPLATE_SET`

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.

### Get Webhook

**Slug:** `BANNERBEAR_GET_WEBHOOK`

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 Project

**Slug:** `BANNERBEAR_HYDRATE_PROJECT`

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.

### Import Template

**Slug:** `BANNERBEAR_IMPORT_TEMPLATE`

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.

### Join PDFs

**Slug:** `BANNERBEAR_JOIN_PDFS`

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.

### List Animated GIFs

**Slug:** `BANNERBEAR_LIST_ANIMATED_GIFS`

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.

### List Collections

**Slug:** `BANNERBEAR_LIST_COLLECTIONS`

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.

### List Effects

**Slug:** `BANNERBEAR_LIST_EFFECTS`

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.

### List Images

**Slug:** `BANNERBEAR_LIST_IMAGES`

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.

### List Projects

**Slug:** `BANNERBEAR_LIST_PROJECTS`

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).

### List Screenshots

**Slug:** `BANNERBEAR_LIST_SCREENSHOTS`

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.

### List Templates

**Slug:** `BANNERBEAR_LIST_TEMPLATES`

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.

### List Template Sets

**Slug:** `BANNERBEAR_LIST_TEMPLATE_SETS`

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.

### List Videos

**Slug:** `BANNERBEAR_LIST_VIDEOS`

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.

### List Video Templates

**Slug:** `BANNERBEAR_LIST_VIDEO_TEMPLATES`

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.

### Update Template Set

**Slug:** `BANNERBEAR_UPDATE_TEMPLATE_SET`

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.
