.png)
Bynder Integration Guide
Connect Bynder’s digital asset management resources with enterprise applications through REST APIs, selected webhook notifications, OAuth 2.0, and controlled file workflows.
Bynder integration options at a glance
Bynder’s primary integration mechanism is its REST API, which supports Media, Metaproperties, Collections, Users, Renditions, and related DAM resources. OAuth 2.0 provides authenticated access subject to portal permissions and scopes. Bynder also supports webhook-style notifications for selected events, although coverage and retry behavior must be confirmed for each portal. Asset APIs support uploads, downloads, and Rendition retrieval, including operations that may involve asynchronous processing. Martini can consume these APIs, receive selected callbacks, transfer binary files, map metadata, run scheduled reconciliation workflows, and expose internal APIs that abstract Bynder-specific details.
Common Bynder integration patterns
Common Bynder data objects used in integrations
Authentication and security considerations
OAuth 2.0 and portal permissions
Bynder API access primarily uses OAuth 2.0 with registered clients, bearer access tokens, scopes, and portal-level permissions. The effective access available to an integration depends on both the OAuth configuration and the Bynder user or client permissions.
Protected configuration
Store client secrets, tokens, portal URLs, and environment-specific API settings in protected Martini configuration or secrets. Do not embed credentials in workflow logic.
Asset access
Media URLs may be temporary or permission-controlled. Treat downloaded references as governed access information and do not assume that a URL can be shared indefinitely or used without authentication.
- Use a dedicated Bynder integration client where possible.
- Apply least-privilege permissions for reading, writing, publishing, or deleting assets.
- Separate development, test, and production portal configuration.
Operational considerations for Bynder integrations
Pagination and checkpoints
Large Media inventories require paginated requests, persisted progress, and restartable workflows. Store checkpoints only after the corresponding work completes successfully.
Rate limits and concurrency
Control request concurrency and use retry behavior for throttling and transient failures. Separate metadata calls from large binary transfers where practical.
Idempotency and event coverage
Webhook deliveries and scheduled runs can overlap or repeat. Use stable Bynder identifiers with event or version markers, and supplement selected callbacks with periodic reconciliation because webhook coverage is limited.
Asynchronous processing
Uploaded or transformed assets and Renditions may not be immediately available. Use bounded polling and retries before treating a derivative as unavailable.
Metadata and schema changes
Metaproperties and controlled values depend on portal configuration. Validate required fields and maintain explicit mappings rather than assuming that every field or value is permanent.
Testing and operations
Test OAuth permissions, pagination, duplicate delivery, missing assets, temporary URLs, large files, delayed Renditions, and downstream failures. Record asset identifiers, checkpoints, request context, and processing status for troubleshooting.
Why use Martini instead of scripts or point-to-point integrations?
Orchestrate more than a single API call
Bynder integrations often combine REST requests, webhook notifications, metadata mapping, binary transfers, approval rules, and reconciliation. Martini coordinates these activities in workflows instead of leaving behavior scattered across scripts.
Maintainable transformations
Martini provides reusable workflow logic and mapping capabilities for converting Media, Metaproperties, Collections, and Renditions into different application models. This makes portal-specific rules explicit and easier to change.
Reliable processing
Checkpointing, idempotency controls, bounded retries, validation, and operational logging help integrations handle large inventories, repeated callbacks, delayed Renditions, and partial failures.
Controlled interfaces
Martini can expose internal REST APIs that shield consuming applications from Bynder-specific details, while environment configuration and secrets keep portal credentials outside implementation logic.