NAV

Introduction

Welcome to the Bannerbear API.

Bannerbear is a service that turns graphic templates into a simple JSON-based API.

  1. Your designer designs a template in Bannerbear
  2. We turn it into an API
  3. You use this API to generate variations of the template in PNG / JPG format

Authentication

To test your API key:

curl "https://api.bannerbear.com/v2/auth"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns a JSON array like this:

{
    "message": "Authorized",
    "project": "My Project Name"
}

Bannerbear uses API keys to allow access to the API. You can get an API key by creating a project in Bannerbear.

Bannerbear expects the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: Bearer API_KEY

Account

To query your account status:

curl "https://api.bannerbear.com/v2/account"
  -H "Authorization: Bearer API_KEY"

Make sure to replace API_KEY with your API key.

{
    "created_at": "2019-10-22T09:49:45.265Z",
    "uid": "jJWBKNELpQPvbX5R93Gk",
    "paid_plan_name": "Bannerbear Marketer",
    "image_api_quota": 1000,
    "image_api_usage_this_month": 409,
    "video_api_quota": 3000,
    "video_api_usage_this_month": 1066,
    "current_project": {
        "name": "My Project Name"
    }
}

To check your account status at any time you can use this endpoint.

It will respond with your quota levels and current usage levels. Usage resets at the start of every month.

Note that video_api_quota and video_api_usage_this_month are in seconds.

Templates

Templates are the reusable designs that you create in the Bannerbear editor. You can list a project's templates via the API.

You can design a template using the Bannerbear template editor, or you can add one from the template library (and modify it as needed).

Every template has a list of modifications available, for example text boxes that you can populate with different text, or image placeholders that you can replace with different images.

List Templates

To list a project's templates:

curl "https://api.bannerbear.com/v2/templates"
  -H "Authorization: Bearer API_KEY"

HTTP Request

GET https://api.bannerbear.com/v2/templates

Get a Specific Template

To get a template:

curl "https://api.bannerbear.com/v2/templates/04PK8K2bctXHjqB97O"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
  "created_at": "2020-03-17T01:58:07.358Z",
  "name": "Twitter Demo",
  "self": "https://api.bannerbear.com/v2/templates/04PK8K2bctXHjqB97O",
  "uid": "04PK8K2bctXHjqB97O",
  "preview_url": null,
  "width": 1000,
  "height": 1000,
  "available_modifications": [
    {
      "name": "avatar",
      "image_url": null
    },
    {
      "name": "name",
      "text": null
    },
    {
      "name": "handle",
      "text": null
    },
    {
      "name": "body",
      "text": null
    }
  ]
}

HTTP Request

GET https://api.bannerbear.com/v2/templates/<uid>

Parameters

Parameter Description
uid The uid of the template to retrieve

Template Preview

Each time you edit a template in Bannerbear, a thumbnail is saved and made available in the preview_url property of the Template object.

Images

An Image is generated from a Template.

You generate images by sending a POST request to Bannerbear with a template uid and a list of template modifications you want to apply. These modifications can be things like: changing the text, changing the images or changing the colors.

Bannerbear will respond with JPG and PNG formats of the new Image you have requested.

List Images

You can get a list of the latest images in this project any time by issuing a GET request to the /images endpoint. This will respond with an array of Image objects.

To list newest images:

curl "https://api.bannerbear.com/v2/images"
  -H "Authorization: Bearer API_KEY"

Create an Image

To create an image:

curl "https://api.bannerbear.com/v2/images"
  -H "Authorization: Bearer API_KEY"
  -H "Content-Type: application/json" 
  -d json

The above endpoint returns JSON like this:

{
  "created_at": "2020-02-20T07:59:23.077Z",
  "status": "pending",
  "self": "https://api.bannerbear.com/v2/images/kG39R5XbvPQpLENKBWJj",
  "uid": "kG39R5XbvPQpLENKBWJj",
  "image_url": null,
  "template": "6A37YJe5qNDmpvWKP0",
  "modifications": [
    {
      "name": "title",
      "text": "Lorem ipsum dolor sit amed",
      "color": null,
      "background": null
    },
    {
      "name": "avatar",
      "image_url": "https://www.bannerbear.com/assets/sample_avatar.jpg"
    }
  ],
  "webhook_url": null,
  "webhook_response_code": null,
  "transparent": false,
  "metadata": null
}

HTTP Request

POST https://api.bannerbear.com/v2/images

POST Parameters

Send as a JSON object

Parameter Type Description
template string The template uid you want to use
modifications array A list of Modifications you want to make
webhook_url
optional
string A url to POST the Image object to upon rendering completed
transparent
optional
boolean Render a PNG with a transparent background. Defaults to false (white backround).
metadata
optional
string Metadata that you need to store e.g. ID of a record in your DB

You can view a sample API payload for any template in the Bannerbear API Console.

Modifications Array

Example modifications:

{
  "modifications": [
    {
      "name": "title",
      "text": "Lorem ipsum dolor sit amed"
    },
    {
      "name": "avatar",
      "image_url": "https://www.bannerbear.com/assets/sample_avatar.jpg"
    }
  ]
}

Your Image API payload should contain a parameter named modifications which is an array of modifications you would like to apply to a template.

All properties are optional, for example if you do not specify a color, the object's default color will be used.

Property Type Description
name string The name of the item you want to change
text string Replacement text you want to use
color string Color hex of object e.g. "#FF0000"
background string Color hex of text background
image_url string Replacement image url you want to use (must be publicly viewable)
chart_data string A comma-delimited list of numbers to send to a Bar Chart object
rating integer A number from 0 to 100 to send to a Star Rating object
hide boolean Set to true to hide an object

Image Response

All images are created with the status pending.

Images are usually rendered within a few seconds. When completed, the status changes to completed.

You can poll the GET endpoint for status updates. The self property of the response provides this endpoint.

When completed the image url is found in the image_url property of the Image object. It will be in PNG format.

You can also grab a JPG version of the image from image_url_jpg.

Webhooks

Instead of polling, we recommended you define a webhook in webhook_url which Bannerbear will POST the Image object to after image rendering is complete.

To secure your webhook endpoint, Bannerbear will POST with the following header:

Authorization: Bearer WEBHOOK_KEY

You can find your project's webhook key in its settings page.

Hotlinking

You may hotlink to image_url or image_url_jpg in your application. The JPG file will download and display faster for your users.

Get a Specific Image

To get an image:

curl "https://api.bannerbear.com/v2/images/kG39R5XbvPQpLENKBWJj"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
  "created_at": "2020-02-20T07:59:23.077Z",
  "status": "completed",
  "self": "https://api.bannerbear.com/v2/images/kG39R5XbvPQpLENKBWJj",
  "uid": "kG39R5XbvPQpLENKBWJj",
  "image_url": "https://cdn.bannerbear.com/...",
  "template": "6A37YJe5qNDmpvWKP0",
  "modifications": [
    {
      "name": "title",
      "text": "Lorem ipsum dolor sit amed",
      "color": null,
      "background": null
    },
    {
      "name": "avatar",
      "image_url": "https://www.bannerbear.com/assets/sample_avatar.jpg"
    }
  ],
  "webhook_url": null,
  "webhook_response_code": null,
  "transparent": false,
  "metadata": null
}

After creating an image request you will receive a uid. You can poll this endpoint to find out when the image has been rendered. When the status is completed the image url will be available in image_url.

HTTP Request

GET https://api.bannerbear.com/v2/images/<uid>

Parameters

Parameter Description
uid The uid of the image to retrieve

Create an Image via GET

Bannerbear also supports creating images via GET request.

In Bannerbear this is achieved using Signed URLs.

Signed URLs product page

Signed URLs documentation

Video Templates

Video Templates are a subset of Templates.

Every Video Template is attached to a Template.

Templates hold design / layout information - as would be required to render Images.

Video Templates simply hold some extra instructions, telling Bannerbear what kind of video to render. This can be seen in the render_type property.

List Video Templates

To list a project's video templates:

curl "https://api.bannerbear.com/v2/video_templates"
  -H "Authorization: Bearer API_KEY"

HTTP Request

GET https://api.bannerbear.com/v2/video_templates

Get a Specific Video Template

To get a video template:

curl "https://api.bannerbear.com/v2/video_templates/GL4kqNvzJ09lYxgVdO"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
  "created_at": "2020-09-15T05:21:22.066Z",
  "self": "http://api.bannerbear.com/v2/video_templates/GL4kqNvzJ09lYxgVdO",
  "uid": "GL4kqNvzJ09lYxgVdO",
  "name": "Quote Example",
  "width": 1000,
  "height": 1000,
  "render_type": "transcribe_audio",
  "available_modifications": [
    {
      "name": "avatar",
      "image_url": null
    },
    {
      "name": "name",
      "text": null,
      "color": null,
      "background": null
    },
    {
      "name": "subtitle",
      "text": null,
      "color": null,
      "background": null
    }
  ]
}

HTTP Request

GET https://api.bannerbear.com/v2/video_templates/<uid>

Parameters

Parameter Description
uid The uid of the video template to retrieve

Videos

A Video is generated from a Video Template.

You generate videos by sending a POST request to Bannerbear with a video template uid, a list of template modifications you want to apply, and a media file.

Bannerbear will respond with an MP4 format of the new Video you have requested.

List Videos

You can get a list of the latest videos in this project any time by issuing a GET request to the /videos endpoint. This will respond with an array of Video objects.

To list newest videos:

curl "https://api.bannerbear.com/v2/videos"
  -H "Authorization: Bearer API_KEY"

Create a Video

To create a video:

curl "https://api.bannerbear.com/v2/videos"
  -H "Authorization: Bearer API_KEY"
  -H "Content-Type: application/json" 
  -d json

The above endpoint returns JSON like this:

{
  "input_audio_url": "https://www.bannerbear.com/audio/test.m4a",
  "created_at": "2020-09-16T05:30:19.568Z",
  "length_in_seconds": 0,
  "approval_required": true,
  "approval_given": false,
  "status": "pending",
  "self": "https://api.bannerbear.com/v2/videos/kG39R5XbvPQpLENKBWJj",
  "uid": "kG39R5XbvPQpLENKBWJj",
  "render_type": "transcribe_audio",
  "video_url": null,
  "modifications": [
    {
      "name": "avatar",
      "image_url": "https://cdn.bannerbear.com/sample_images/welcome_bear_photo.jpg"
    }
  ],
  "webhook_url": null,
  "webhook_response_code": null,
  "metadata": null,
  "transcription": null
}

HTTP Request

POST https://api.bannerbear.com/v2/videos

POST Parameters

Send as a JSON object

Parameter Type Description
video_template string The video template uid you want to use
input_audio_url
optional
string Full url to an audio file you want to import,
in m4a/wav/mp3 format
input_video_url
optional
string Full url to a video file you want to import,
in m4v/mp4/3gp/webm format
modifications
optional
array A list of Modifications you want to make
webhook_url
optional
string A url to POST the Image object to upon rendering completed
metadata
optional
string Metadata that you need to store e.g. ID of a record in your DB

You can view a sample API payload for any template in the Bannerbear API Console.

The modifications array follows the same format as an Image modifications array.

View the Images section for more information on modifications.

Video Inputs

Depending on the type of video you are creating (defined in the render_type of the Video Template) your payload may need to contain media inputs.

Render Type Requirements
transcribe_audio Requires an input_audio_url
transcribe_video Requires an input_video_url
overlay_video Requires an input_video_url

Bannerbear will validate your payload when you POST to ensure it has the right inputs for the render type, before rendering begins.

Video Response

All videos are created with the status pending.

Video rendering time depends on length / complexity of the video. It can vary from a few seconds to a few minutes. When completed, the status changes to completed.

You can poll the GET endpoint for status updates. The self property of the response provides this endpoint.

When completed the video url is found in the video_url property of the Video object. It will be in MP4 format.

Webhooks

Instead of polling, we recommended you define a webhook in webhook_url which Bannerbear will POST the Video object to after video rendering is complete.

To secure your webhook endpoint, Bannerbear will POST with the following header:

Authorization: Bearer WEBHOOK_KEY

You can find your project's webhook key in its settings page.

Hotlinking

Video hotlinking is discouraged due to the potentially large bandwidth requirements. If you are using Bannerbear videos in a high-traffic scenario it is recommended you save the videos and serve from your own platform.

Get a Specific Video

To get an image:

curl "https://api.bannerbear.com/v2/videos/kG39R5XbvPQpLENKBWJj"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
  "input_audio_url": "https://www.bannerbear.com/audio/test.m4a",
  "created_at": "2020-09-16T05:30:19.568Z",
  "length_in_seconds": 16,
  "approval_required": true,
  "approval_given": false,
  "status": "pending_approval",
  "self": "http://api.bblocaldev.com:5000/v2/videos/kG39R5XbvPQpLENKBWJj",
  "uid": "kG39R5XbvPQpLENKBWJj",
  "render_type": "transcribe_audio",
  "video_url": null,
  "modifications": [
    {
      "name": "avatar",
      "image_url": "https://cdn.bannerbear.com/sample_images/welcome_bear_photo.jpg"
    }
  ],
  "webhook_url": null,
  "webhook_response_code": null,
  "metadata": null,
  "transcription": [
    "Okay, this is a voice memo that I'm just using",
    "as a test because I'm going to try to auto transcribe",
    "and create a video from this voice memo."
  ]
}

After creating an video request you will receive a uid. You can poll this endpoint to find out when the video has been rendered. When the status is completed the video url will be available in video_url.

HTTP Request

GET https://api.bannerbear.com/v2/videos/<uid>

Parameters

Parameter Description
uid The uid of the video to retrieve

Edit a Video

Video Templates have an approval_required boolean setting.

When approval_required is false rendering starts after the Create Video request.

When approval_required is true all video requests go through an approval workflow. When the video status is pending_approval the video will be held until a user takes further action, either via the Bannerbear dashboard or the API.

Edit and Approve actions are only relevant when approval_required is true.

Currently the main reason for setting approval_required to true is to check that the automatic audio transcription is accurate, and to make any adjustments required.

HTTP Request

PATCH https://api.bannerbear.com/v2/videos

PATCH Parameters

Send as a JSON object

Parameter Type Description
uid string The uid of the video to patch
transcription array An array of strings of your new transcription

Note that 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 is meant for minor corrections, not making major changes.

Approve a Video

To approve a video and start the rendering process, set approval_given to true.

HTTP Request

PATCH https://api.bannerbear.com/v2/videos

PATCH Parameters

Send as a JSON object

Parameter Type Description
uid string The uid of the video to patch
approval_given boolean Set to true to begin rendering

Errors

The Bannerbear API uses the following error codes:

Error Code Meaning
202 Accepted -- Your request is has been accepted for processing
200 OK
400 Bad Request -- Your request is invalid.
401 Unauthorized -- Your API key is wrong.
404 Not Found -- The specified request could not be found.
429 Too Many Requests -- Slow down!
500 Internal Server Error -- We had a problem with our server. Try again later.
503 Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

The Bannerbear API rate limit is 10 requests per 10 seconds.

Advanced

Collections

Sometimes you want to use the same data payload but push to multiple templates at once. In Bannerbear, you can do this by grouping templates together in a Template Set. Pushing data to a Template Set results in a response that includes multiple images (depending on how many templates were in your set).

This multi-image object is known as a Collection.

Create a Collection

To create a collection:

curl "https://api.bannerbear.com/v2/collections"
  -H "Authorization: Bearer API_KEY"
  -H "Content-Type: application/json" 
  -d json

The above endpoint returns JSON like this:

{
  "created_at": "2020-07-31 04:28:32 UTC",
  "uid": "rZdpMYmAnDB1zb3kXL",
  "self": "https://api.bannerbear.com/v2/collections/rZdpMYmAnDB1zb3kXL",
  "template_set": "Dbl5xYVgKRzLwaNdqo",
  "status": "completed",
  "modifications": [
    {
      "name": "text_container",
      "text": "Hello World"
    }
  ],
  "webhook_url": null,
  "webhook_response_code": null,
  "image_urls": {
    "template_EagXkA3DwM1ZW2VBYw_image_url": "https://cdn.bannerbear.com/...",
    "template_197xPQmDnLqZG3E82Y_image_url": "https://cdn.bannerbear.com/..."
  },
  "images": [
    //array of Image objects
  ]
}

HTTP Request

POST https://api.bannerbear.com/v2/collections

Post Parameters

Send as a JSON object

Parameter Type Description
template_set string The template set uid you want to use
modifications array A list of Modifications you want to make
webhook_url
optional
string A url to POST the Collection object to upon rendering completed

For more information on the modifications parameter, see the Images endpoint.

Status

All collections are created with the status pending.

Collections are usually rendered within a few seconds. When completed, the status changes to completed.

You can poll the GET endpoint for status updates. The self property of the response provides this endpoint. Alternatively you can provide a webhook to get notified when generation is completed.

Get a Specific Collection

To get a collection:

curl "https://api.bannerbear.com/v2/collections/rZdpMYmAnDB1zb3kXL"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
  "created_at": "2020-07-31 04:28:32 UTC",
  "uid": "rZdpMYmAnDB1zb3kXL",
  "self": "https://api.bannerbear.com/v2/collections/rZdpMYmAnDB1zb3kXL",
  "template_set": "Dbl5xYVgKRzLwaNdqo",
  "status": "completed",
  "modifications": [
    {
      "name": "text_container",
      "text": "Hello World"
    }
  ],
  "webhook_url": null,
  "webhook_response_code": null,
  "image_urls": {
    "template_EagXkA3DwM1ZW2VBYw_image_url": "https://cdn.bannerbear.com/...",
    "template_197xPQmDnLqZG3E82Y_image_url": "https://cdn.bannerbear.com/..."
  },
  "images": [
    //array of Image objects
  ]
}

HTTP Request

GET https://api.bannerbear.com/v2/collections/<uid>

Parameters

Parameter Description
uid The uid of the collection to retrieve

Crawlers

The Crawler object represents a set of CSS selectors to use for data extraction from a website. Crawler configuration can be edited via the Bannerbear control panel.

Crawlers belong to a Template which is included in the response object.

List Crawlers

To list a project's crawlers:

curl "https://api.bannerbear.com/v2/crawlers"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns a JSON array like this:

[
  {
    "domain": "mywebsite.com",
    "created_at": "2020-06-08T01:39:31.101Z",
    "self": "https://api.bannerbear.com/v2/crawlers/pw2D9Ab16lEl0ayGRN",
    "uid": "pw2D9Ab16lEl0ayGRN",
    "config": {
      "poster": {
        "selector": "meta[name=\"twitter:image:src\"]",
        "attribute": "content"
      },
      "title": {
        "selector": "h1"
      }
    },
    "template": {
      "created_at": "2020-06-05T21:59:34.361Z",
      "name": "Template 25",
      "self": "https://api.bannerbear.com/v2/templates/p6jq8BX57gY5nlwWaK",
      "uid": "p6jq8BX57gY5nlwWaK",
      "preview_url": "https://cdn.bannerbear.com/...",
      "width": 1200,
      "height": 630,
      "available_modifications": [
        {
          "name": "poster",
          "image_url": null
        },
        {
          "name": "title",
          "text": null,
          "color": null,
          "background": null
        }
      ]
    }
  }
]

HTTP Request

GET https://api.bannerbear.com/v2/crawlers

Get a Specific Crawler

To get a crawler:

curl "https://api.bannerbear.com/v2/crawlers/pw2D9Ab16lEl0ayGRN"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
  "domain": "mywebsite.com",
  "created_at": "2020-06-08T01:39:31.101Z",
  "self": "https://api.bannerbear.com/v2/crawlers/pw2D9Ab16lEl0ayGRN",
  "uid": "pw2D9Ab16lEl0ayGRN",
  "config": {
    "poster": {
      "selector": "meta[name=\"twitter:image:src\"]",
      "attribute": "content"
    },
    "title": {
      "selector": "h1"
    }
  },
  "template": {
    "created_at": "2020-06-05T21:59:34.361Z",
    "name": "Template 25",
    "self": "https://api.bannerbear.com/v2/templates/p6jq8BX57gY5nlwWaK",
    "uid": "p6jq8BX57gY5nlwWaK",
    "preview_url": "https://cdn.bannerbear.com/...",
    "width": 1200,
    "height": 630,
    "available_modifications": [
      {
        "name": "poster",
        "image_url": null
      },
      {
        "name": "title",
        "text": null,
        "color": null,
        "background": null
      }
    ]
  }
}

HTTP Request

GET https://api.bannerbear.com/v2/crawlers/<uid>

Parameters

Parameter Description
uid The uid of the crawler to retrieve

Crawls

The Crawl object represents a crawl you have requested to start. A Crawl extracts data from a webpage in order to generate an Image. Crawls take a url and crawler uid as input. The rules for data extraction are held in the Crawler object.

Start a Crawl

To create a request:

curl "https://api.bannerbear.com/v2/crawls"
  -H "Authorization: Bearer API_KEY"
  -H "Content-Type: application/json" 
  -d json

The above endpoint returns JSON like this:

{
  "url": "https://www.mywebsite.com/my-page.html",
  "created_at": "2020-06-08T07:32:23.902Z",
  "self": "https://api.bannerbear.com/v2/crawls/W7ErAeVjZAb6G1MpNQ",
  "uid": "W7ErAeVjZAb6G1MpNQ",
  "status": "pending",
  "image": null,
  "crawler": "pw2D9Ab16lEl0ayGRN"
}

HTTP Request

POST https://api.bannerbear.com/v2/crawls

Post Parameters

Send as a JSON object

Parameter Type Description
crawler string The crawler uid you want to use
url string A publicly-viewable url you want to crawl
webhook_url
optional
string A url to POST the Image object to upon rendering completed

Status

All crawls are created with the status pending.

End to end, a crawl usually takes a few seconds.

The url is crawled, after which an Image generation operation starts. When finished, the status changes to completed and the full Image object is available in the image property of the Crawl object.

You can poll the GET endpoint for status updates. The self property of the response provides this endpoint.

Webhooks

Instead of polling, we recommended you define a webhook in webhook_url which Bannerbear will POST the Image object to after image rendering is complete. The rendered image url is found in the image_url property of the Image object.

Get a Specific Crawl

To get a crawl:

curl "https://api.bannerbear.com/v2/crawls/W7ErAeVjZAb6G1MpNQ"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
  "url": "https://www.mywebsite.com/my-page.html",
  "created_at": "2020-06-08T07:32:23.902Z",
  "self": "https://api.bannerbear.com/v2/crawls/W7ErAeVjZAb6G1MpNQ",
  "uid": "W7ErAeVjZAb6G1MpNQ",
  "status": "completed",
  "image": {
    "created_at": "2020-06-09T03:09:41.306Z",
    "status": "completed",
    "self": "https://api.bannerbear.com/v2/images/yMRj52Zwoa6xZ5YxWkdO3eE9P",
    "uid": "yMRj52Zwoa6xZ5YxWkdO3eE9P",
    "image_url": "https://cdn.bannerbear.com/...",
    "template": "p6jq8BX57gY5nlwWaK",
    "modifications": [
      {
        "name": "title",
        "text": "This is a title"
      }
    ],
    "webhook_url": null,
    "webhook_response_code": null,
    "metadata": null
  },
  "crawler": "pw2D9Ab16lEl0ayGRN"
}

After starting a crawl you will receive a uid. You can poll this endpoint to find out when the image has been rendered from the crawl. When the status is completed the full Image object will be available in the image key of the Crawl object.

HTTP Request

GET https://api.bannerbear.com/v2/crawls/<uid>

Parameters

Parameter Description
uid The uid of the crawl to retrieve

Airtable

Airtable Import

To start an import:

curl -X POST "https://api.bannerbear.com/v2/templates/04PK8K2bctXHjqB97O/airtable"
  -H "Authorization: Bearer API_KEY"

The above endpoint returns JSON like this:

{
    "message": "Airtable import has started"
}

HTTP Request

POST https://api.bannerbear.com/v2/templates/<uid>/airtable

Parameters

Parameter Description
uid The uid of the template to initiate Airtable Import on

If you have an airtable connected to a template you can initiate an airtable import by issuing a POST request to this endpoint.

This endpoint responds with simple success or failure message. Images are not returned by this endpoint.

To see new Images as they are imported from Airtable you can watch the List Images endpoint which lists all new images.