Skip to main content
GET
List bindings

Bindings

Bindings connect templates to external data sources, enabling automatic image generation when data changes. Perfect for dynamic dashboards, real-time stats, and automated social media images.
For a step-by-step tutorial, see Webhook Integration.

How Bindings Work

  1. Create a binding — link a template to an external data URL
  2. Pictify fetches data — based on your refresh policy
  3. Template renders — variables from the data are injected into the template
  4. Image updates — the rendered image URL stays the same, content updates automatically

Endpoints

Binding Status

Refresh Policy Types

Data Mapping

Map fields from your API response to template variables using dot notation and array access:

Data Source Authentication

Binding Events

Subscribe to binding events via Webhooks:

Best Practices

  1. Set appropriate TTL — don’t refresh more often than data changes
  2. Use defaults — provide fallback values for missing fields
  3. Handle errors gracefully — use serve_stale for critical images
  4. Monitor binding health — set up webhooks for binding.failed events
  5. Test before deploying — validate your data source and mapping first

Authorizations

Authorization
string
header
required

API key obtained from the Pictify dashboard

Query Parameters

templateId
string
status
enum<string>
Available options:
active,
paused,
error
page
integer
default:1
limit
integer
default:20

Response

200 - application/json

List of bindings

bindings
object[]
pagination
object