Bannerbear
The Bannerbear modules allow you to monitor, create, update, send, retrieve, and list the collections, images, and videos, in your Bannerbear account.
Getting Started with Bannerbear
Prerequisites
- A Banner Bear account - create an account at bannerbear.com/.
The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!
Connecting Bannerbear to Integromat
To connect your Bannerbear account to Integromat you need to obtain the API Key from your Bannerbear account and insert it in the Create a connection dialog in the Integromat module.
1. Log in to your Bannerbear account.
2. Click Projects > Select the project for which you want to establish the connection > Setting / API Key.
3. Copy the API Key to your clipboard.
4. Go to Integromat and open the Bannerbear module's Create a connection dialog.
5. In the Connection name field, enter a name for the connection.
6. In the API Key field, enter the API key copied in step 3, and click Continue.
The connection has been established.
Image
Watch New Image
Watches for a new image.
See the Setting Up Bannerbear Webhooks for adding the webhooks in your Bannerbear account.
Webhook Name | Enter (map) a name for the webhook. |
Connection | Establish a connection to your Bannerbear account. |
List Images
Lists all images.
Connection | Establish a connection to your Bannerbear account. |
Limit | Set the maximum number of images Integromat should return during one execution cycle. |
Get an Image
Gets an image.
Connection | Establish a connection to your Bannerbear account. |
Image UUID | Select or map the Image UUID whose details you want to retrieve. |
Create an Image
Creates an image.
Connection | Establish a connection to your Bannerbear account. | ||||||||||||||||||||||||||
Template UUID | Select or map the Template UUID for the image you want to create. | ||||||||||||||||||||||||||
Modifications | Add the changes you want to make to the image you want to create:
| ||||||||||||||||||||||||||
Webhook URL | Enter (map) the webhook URL address to post the image after the rendering is completed. | ||||||||||||||||||||||||||
Transparent | Select whether you want to keep the transparent background for the image. | ||||||||||||||||||||||||||
Metadata | Enter (map) the metadata for the image. For example, the ID of a record in your DB. |
Video
See the Setting Up Bannerbear Webhooks for adding the webhooks in your Bannerbear account.
Watch New Video Template
Watch for a new video template.
Webhook Name | Enter (map) a name for the webhook. |
Connection | Establish a connection to your Bannerbear account. |
Watch New Video Pending Approval or Completed
Watches for a new video that is pending approval or completion.
Webhook Name | Enter (map) a name for the webhook. |
Connection | Establish a connection to your Bannerbear account. |
List Videos
Lists all videos.
Connection | Establish a connection to your Bannerbear account. |
Limit | Set the maximum number of videos Integromat should return during one execution cycle. |
Status | Select or map the status of the video:
|
Get a Video
Gets a video.
Connection | Establish a connection to your Bannerbear account. |
Video UUID | Select or map the Video UUID whose details you want to retrieve. |
Create a Video
Creates a video.
Connection | Establish a connection to your Bannerbear account. | ||||||||||||||||||
Video Template UUID | Select or map the Template UUID for the video you want to create. | ||||||||||||||||||
Input Media URL | Enter (map) the URL address of the video or audio file. | ||||||||||||||||||
Modifications | Add the changes you want to make to the video you want to create:
| ||||||||||||||||||
Webhook URL | Enter (map) the webhook URL address to post the image after the rendering is completed. | ||||||||||||||||||
Metadata | Enter (map) the metadata for the video. For example, the ID of a record in your DB. | ||||||||||||||||||
Trim to Length in Seconds | Enter the seconds for which you want to remove the content from the video or audio file. |
Update a Video
Modifies a video.
Connection | Establish a connection to your Bannerbear account. |
Video UUID | Select or map the Video UUID whose details you want to update. |
Transcription | Add the transcriptions for the video which you want to update. An array of strings of your new transcription. Please Note: Each element of the transcription array represents a specific timestamp. For that reason, the number of lines of your patched text must match the original. Bannerbear will not update the record if the number is different. Editing transcriptions are meant for minor corrections, not making major changes. |
Approve a Video
Approves a video.
Connection | Establish a connection to your Bannerbear account. |
Video UUID | Select or map the Video UUID you want to approve. |
Delete a Video
Rejects a video.
Connection | Establish a connection to your Bannerbear account. |
Video UUID | Select or map the Video UUID you want to delete. |
Collection
List Collections
Lists all collections.
Connection | Establish a connection to your Bannerbear account. |
Limit | Set the maximum number of collections Integromat should return during one execution cycle. |
Get a Collection
Gets a collection.
Connection | Establish a connection to your Bannerbear account. |
Collection UUID | Select or map the Collection UUID whose details you want to retrieve. |
Create a Collection
Creates a collection.
Connection | Establish a connection to your Bannerbear account. | ||||||||||||||||||
Template Set UUID | Select or map the Template Set UUID for the collection you want to create. | ||||||||||||||||||
Modifications | Add the changes you want to make to the collection you want to create:
| ||||||||||||||||||
Webhook URL | Enter (map) the webhook URL address to post the image after the rendering is completed. | ||||||||||||||||||
Metadata | Enter (map) the metadata for the video. For example, the ID of a record in your DB. |
Other
Watch New Template
Watches for a new template.
See the Setting Up Bannerbear Webhooks for adding the webhooks in your Bannerbear account.
Webhook Name | Enter (map) a name for the webhook. |
Connection | Establish a connection to your Bannerbear account. |
Make an API Call
Performs an arbitrary authorized API call.
Connection | Establish a connection to your Bannerbear account. |
URL | Enter a path relative to For the list of available endpoints, refer to the Bannerbear API Documentation. |
Method | Select the HTTP method you want to use: GET POST PUT PATCH DELETE |
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
Example of Use - List Images
The following API call returns all the images from your Bannerbear account:
URL:/v1/images
Method:GET
Matches of the search can be found in the module's Output under Bundle > Body.
In our example, 3 images were returned:
Create an Animated Gif
Creates an animated gif.
Connection | Establish a connection to your Bannerbear account. | ||||||||||||||||||||||||||
Template UUID | Select or map the Template UUID for the gif you want to create. | ||||||||||||||||||||||||||
Frames | Add the frames you want to make to the gif you want to create:
| ||||||||||||||||||||||||||
Set FPS Value | Select or map the frame per second value. | ||||||||||||||||||||||||||
Fram Duration | Enter (map) a value for the frame duration. | ||||||||||||||||||||||||||
FPS | Enter (map) the frame per second for the gif. | ||||||||||||||||||||||||||
Loop | Select whether the gif is looped. | ||||||||||||||||||||||||||
Webhook URL | Enter (map) the webhook URL address to post the image after the rendering is completed. | ||||||||||||||||||||||||||
Transparent | Select whether you want to keep the transparent background for the image. | ||||||||||||||||||||||||||
Metadata | Enter (map) the metadata for the image. For example, the ID of a record in your DB. |
Uncategorized
Get Fonts Collection
Gets a collection of fonts.
Connection | Establish a connection to your Bannerbear account. |
Setting Up Bannerbear Webhooks
1. Open any Watch module, establish a connection, click Save, and copy the URL address to your clipboard.
2. Log in to your Bannerbear account.
3. Click Projects > Open the project > Setting/API > Advanced Settings and navigate to the webhook section.
4. In the Endpoint URL field, enter the URL address copied in step 1 and select the event for which you want to receive the alerts.
5. Click Create Webhook.
You have successfully added the webhook. Go to Integromat and run the scenario to receive the trigger when the specified event occurs.