# Bannerbear

```json
{
  "name": "Bannerbear",
  "slug": "bannerbear",
  "url": "https://composio.dev/toolkits/bannerbear",
  "markdown_url": "https://composio.dev/toolkits/bannerbear.md",
  "logo_url": "https://logos.composio.dev/api/bannerbear",
  "categories": [
    "design & creative tools"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:02:24.990Z"
}
```

![Bannerbear logo](https://logos.composio.dev/api/bannerbear)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Bannerbear MCP or direct API to generate images, render videos, update templates, and manage creative assets through natural language.

## Summary

Bannerbear is an API-driven platform for generating images and videos automatically at scale. It helps businesses create custom graphics, social visuals, and marketing assets using powerful templates.

## Categories

- design & creative tools

## Toolkit Details

- Tools: 33

## Images

- Logo: https://logos.composio.dev/api/bannerbear

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Bannerbear.
  - Setup:
    - Configure Api Key credentials for Bannerbear.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Merge multiple marketing PDFs into one file
- List all video assets created this week
- Get available fonts for Instagram templates
- Retrieve details for a specific template set

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `BANNERBEAR_CREATE_PROJECT` | 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. |
| `BANNERBEAR_CREATE_SIGNED_BASE` | 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. |
| `BANNERBEAR_CREATE_TEMPLATE` | 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. |
| `BANNERBEAR_CREATE_TEMPLATE_SET` | 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. |
| `BANNERBEAR_CREATE_VIDEO_TEMPLATE` | 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. |
| `BANNERBEAR_CREATE_WEBHOOK` | 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. |
| `BANNERBEAR_DELETE_TEMPLATE` | 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. |
| `BANNERBEAR_DELETE_WEBHOOK` | 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). |
| `BANNERBEAR_GET_ACCOUNT_INFO` | 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. |
| `BANNERBEAR_GET_ANIMATED_GIF` | 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. |
| `BANNERBEAR_GET_AUTH` | Get Auth Status | 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. |
| `BANNERBEAR_GET_FONTS` | Get Available 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. |
| `BANNERBEAR_GET_IMAGE` | 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. |
| `BANNERBEAR_GET_PROJECT` | 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. |
| `BANNERBEAR_GET_SCREENSHOT` | 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. |
| `BANNERBEAR_GET_SIGNED_BASES` | 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. |
| `BANNERBEAR_GET_TEMPLATE` | 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. |
| `BANNERBEAR_GET_TEMPLATE_SET` | Get Template Set Details | 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. |
| `BANNERBEAR_GET_WEBHOOK` | 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. |
| `BANNERBEAR_HYDRATE_PROJECT` | 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. |
| `BANNERBEAR_IMPORT_TEMPLATE` | 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. |
| `BANNERBEAR_JOIN_PDFS` | 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. |
| `BANNERBEAR_LIST_ANIMATED_GIFS` | 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. |
| `BANNERBEAR_LIST_COLLECTIONS` | 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. |
| `BANNERBEAR_LIST_EFFECTS` | 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. |
| `BANNERBEAR_LIST_IMAGES` | 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. |
| `BANNERBEAR_LIST_PROJECTS` | 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). |
| `BANNERBEAR_LIST_SCREENSHOTS` | 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. |
| `BANNERBEAR_LIST_TEMPLATES` | 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. |
| `BANNERBEAR_LIST_TEMPLATE_SETS` | 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. |
| `BANNERBEAR_LIST_VIDEOS` | 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. |
| `BANNERBEAR_LIST_VIDEO_TEMPLATES` | 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. |
| `BANNERBEAR_UPDATE_TEMPLATE_SET` | 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. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Bannerbear Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Bannerbear actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Generate a social media image using the product launch template'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Generate a social media image using the product launch template'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Bannerbear tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('List templates available in my Bannerbear project')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'List templates available in my Bannerbear project' }],
  stopWhen: stepCountIs( 5 )
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Bannerbear Integration

- Supports both Bannerbear MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Bannerbear data

### 2. Managed Auth

- Built-in API key storage with secure rotation
- Central place to manage, scope, and revoke Bannerbear access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Bannerbear
- Scoped, least privilege access to Bannerbear resources
- Full audit trail of agent actions to support review and compliance

## Use Bannerbear with any AI Agent Framework

Choose a framework you want to connect Bannerbear with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/bannerbear/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/bannerbear/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/bannerbear/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/bannerbear/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/bannerbear/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/bannerbear/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/bannerbear/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/bannerbear/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/bannerbear/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/bannerbear/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/bannerbear/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/bannerbear/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/bannerbear/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/bannerbear/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/bannerbear/framework/autogen)

## Related Toolkits

- [Figma](https://composio.dev/toolkits/figma) - Figma is a collaborative interface design tool for teams and individuals. It streamlines design workflows with real-time collaboration and easy sharing.
- [Abyssale](https://composio.dev/toolkits/abyssale) - Abyssale is a creative automation platform for generating images, videos, GIFs, PDFs, and HTML5 content programmatically. It streamlines and scales visual content production for marketing, design, and operations teams.
- [Alttext ai](https://composio.dev/toolkits/alttext_ai) - AltText.ai is a service that generates alt text for images automatically. It helps boost accessibility and SEO for your visual content.
- [Canva](https://composio.dev/toolkits/canva) - Canva is a drag-and-drop design suite for creating professional graphics, presentations, and marketing materials. It makes it easy for anyone to design with beautiful templates and a vast library of elements.
- [Claid ai](https://composio.dev/toolkits/claid_ai) - Claid.ai delivers AI-driven image editing APIs for tasks like background removal, upscaling, and color correction. It helps automate and enhance image workflows with powerful, developer-friendly tools.
- [Cloudinary](https://composio.dev/toolkits/cloudinary) - Cloudinary is a cloud-based platform for managing, uploading, and transforming images and videos. It streamlines media workflows and delivers optimized assets globally.
- [Cults](https://composio.dev/toolkits/cults) - Cults is a digital marketplace for 3D printing models, connecting designers and makers. It lets creators share, sell, and discover a huge variety of printable designs easily.
- [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks.
- [Dreamstudio](https://composio.dev/toolkits/dreamstudio) - DreamStudio is Stability AI’s platform for generating and editing images with AI. It lets you easily turn ideas into stunning visuals, fast.
- [Dynapictures](https://composio.dev/toolkits/dynapictures) - Dynapictures is a cloud-based platform for generating personalized images at scale. Instantly create hundreds of custom visuals using your data sources, like Google Sheets.
- [Fal.ai](https://composio.dev/toolkits/fal_ai) - Fal.ai is a generative media platform offering 600+ AI models for images, video, voice, and audio. Developers use Fal.ai for fast, scalable access to cutting-edge generative AI tools.
- [Gamma](https://composio.dev/toolkits/gamma) - Gamma is an AI-powered platform for making beautiful, interactive presentations and documents. It lets anyone create and share engaging decks with minimal effort.
- [Html to image](https://composio.dev/toolkits/html_to_image) - Html to image converts HTML and CSS into images or captures web page screenshots. Instantly generate visuals from code or web content—no manual screenshots needed.
- [Imagior](https://composio.dev/toolkits/imagior) - Imagior is an AI-powered image generation platform that lets you create and customize images using dynamic templates and APIs. Perfect for businesses and creators needing fast, scalable visuals without design hassle.
- [Imejis io](https://composio.dev/toolkits/imejis_io) - Imejis io is an API-based image generation platform with powerful customization and template support. It lets you create and modify images in seconds, no manual design work required.
- [Imgix](https://composio.dev/toolkits/imgix) - Imgix is a real-time image processing and delivery service for developers. It helps you optimize, transform, and deliver images efficiently at any scale.
- [Kraken io](https://composio.dev/toolkits/kraken_io) - Kraken.io is an image optimization and compression platform. It helps you shrink image file sizes while keeping visual quality intact.
- [Logo dev](https://composio.dev/toolkits/logo_dev) - Logo.dev is an API and database for high-resolution company logos and brand metadata. Instantly fetch official logos from any domain without scraping or manual searching.
- [Miro](https://composio.dev/toolkits/miro) - Miro is a collaborative online whiteboard platform for teams to brainstorm, design, and manage projects visually. It streamlines teamwork by enabling real-time idea sharing, diagramming, and workflow planning in a single space.
- [Mural](https://composio.dev/toolkits/mural) - Mural is a digital whiteboard platform for distributed visual collaboration. It helps teams brainstorm, map ideas, and diagram together in real time.

## Frequently Asked Questions

### Do I need my own developer credentials to use Bannerbear with Composio?

Yes, Bannerbear requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)