Bynder Component

Bynder is a leading digital asset management software that allows users to easily create, find, and use content, such as documents, graphics, and videos.

Component key: bynder

Description

Bynder is a leading digital asset management software that allows users to easily create, find, and use content, such as documents, graphics, and videos.

Use the Bynder component to manage Assets, Collections, Campaigns, and more.

API Documentation

The Bynder component is built using the Bynder April 2024 REST API

Connections

OAuth 2.0 Client Credentials

key: bynder-client-credentials-oauth

To create a new OAuth App for the Client Credentials flow:

Prerequisites

A Bynder account with administrator access to Portal Settings

Setup Steps

Sign into Bynder and navigate to Settings > Advanced Settings > Portal Settings and select OAuth Apps
Select Register new application to create an OAuth App
Set Grant Type to Client Credentials and configure the assigned user:
- Choose the user for which tokens will be issued. Enter the name of the user and click one of the returned search results. A dedicated user in the portal is recommended if one does not already exist.
Add at least the following scopes: asset:read asset:write collection:read collection:write
Select Register application to retrieve a Client ID and Client Secret

Configure the Connection

Create a connection of type OAuth 2.0 Client Credentials and enter:

Token URL: The Bynder token URL (e.g., https://{your-bynder-domain}/v6/authentication/oauth2/token)
Scopes: The required OAuth scopes (defaults are pre-populated)
Client ID: The Client ID from the registered OAuth application
Client Secret: The Client Secret from the registered OAuth application

Input	Notes	Example
Client ID	The Client ID from the Bynder OAuth application credentials.	12345678-1234-1234-1234-123456789abc
Client Secret	The Client Secret from the Bynder OAuth application credentials.
Scopes	Space-separated list of OAuth permission scopes granted to the access token.	asset:read asset:write collection:read collection:write current.user:read current.profile:read workflow.campaign:read workflow.campaign:write workflow.job:read workflow.job:write brandstore.order:read brandstore.order:write meta.assetbank:read meta.assetbank:write admin.profile:read admin.user:read admin.user:write workflow.preset:read offline
Token URL	The OAuth 2.0 token URL used to exchange the client credentials for an access token.	https://portal.bynder.com/v6/authentication/oauth2/token

OAuth 2.0

key: bynder-oauth

To create a new OAuth App for the OAuth 2.0 Authorization Code flow:

Prerequisites

A Bynder account with administrator access to Portal Settings

Setup Steps

Sign into Bynder and navigate to Settings > Advanced Settings > Portal Settings and select OAuth Apps
Select Register new application to create an OAuth App
Set Grant Type to Authorization Code and configure the redirect URL:
- Set the redirect URI to https://oauth2.prismatic.io/callback
Add at least the following scopes: asset:read asset:write collection:read collection:write
Select Register application to retrieve a Client ID and Client Secret

Configure the Connection

Create a connection of type OAuth 2.0 and enter:

Authorize URL: The Bynder authorization URL (e.g., https://{your-bynder-domain}/v6/authentication/oauth2/auth)
Token URL: The Bynder token URL (e.g., https://{your-bynder-domain}/v6/authentication/oauth2/token)
Scopes: The required OAuth scopes (defaults are pre-populated)
Client ID: The Client ID from the registered OAuth application
Client Secret: The Client Secret from the registered OAuth application

Input	Notes	Example
Authorize URL	The OAuth 2.0 authorization URL for the Bynder domain.	https://portal.bynder.com/v6/authentication/oauth2/auth
Client ID	The Client ID from the Bynder OAuth application credentials.	12345678-1234-1234-1234-123456789abc
Client Secret	The Client Secret from the Bynder OAuth application credentials.
Scopes	Space-separated list of OAuth permission scopes granted to the access token.	asset:read asset:write collection:read collection:write current.user:read current.profile:read workflow.campaign:read workflow.campaign:write workflow.job:read workflow.job:write brandstore.order:read brandstore.order:write meta.assetbank:read meta.assetbank:write admin.profile:read admin.user:read admin.user:write workflow.preset:read offline
Token URL	The OAuth 2.0 token URL used to exchange the authorization code for an access token.	https://portal.bynder.com/v6/authentication/oauth2/token

Data Sources

Select Campaign

Select a campaign from the list of campaigns available in Bynder. | key: selectCampaign | type: picklist

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "result": [
    {
      "key": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
      "label": "Example campaign (ID: B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901)"
    }
  ]
}

Select Collection

Select a collection from the list of collections available in Bynder. | key: selectCollection | type: picklist

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "result": [
    {
      "key": "B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901",
      "label": "Collection 1 (ID: B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901)"
    }
  ]
}

Select Job

Select a job from the list of jobs available in Bynder. | key: selectJob | type: picklist

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "result": [
    {
      "key": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234",
      "label": "Test API (ID: E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234)"
    }
  ]
}

Actions

Add Asset Metaproperty Options

Add metaproperty options to an asset | key: addAssetMetapropertyOptions

Input	Notes	Example
Asset ID	Id of the asset.	00000000-0000-0000-0000000000000000
Connection	The Bynder connection to use.
Metaproperty ID	The unique identifier of the metaproperty from which to add options.	00000000-0000-0000-0000000000000000
Metaproperty Options IDs	The list of metaproperty option IDs to add to the asset.	00000000-0000-0000-0000000000000000

{
  "data": {
    "message": "Created",
    "statuscode": 201
  }
}

Close Campaign

Delete an existing campaign | key: closeCampaign

Input	Notes	Example
Connection	The Bynder connection to use.
Campaign ID	The ID of the campaign to delete	00000000-0000-0000-0000000000000000

{
  "data": {}
}

Create Campaign

Create a new campaign | key: createCampaign

Input	Notes	Example
Data	Additional data to update the campaign
Connection	The Bynder connection to use.
Description	The description of the campaign	Official company logo for external use, approved by marketing.
Key	A 4-character key representing the campaign.	CAMP
Name	The name of the campaign	Company Logo 2024
Responsible ID	The unique identifier of the user responsible for the campaign.	00000000-0000-0000-0000-000000000000

{
  "data": {
    "name": "Example campaign",
    "key": "excp",
    "description": "Campaign example",
    "dateStart": "2015-01-01T00:00:00",
    "deadline": "2015-09-04T00:00:00",
    "responsibleID": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "campaignMetaproperties": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234"
  }
}

Create Collection

Create a new collection | key: createCollection

Input	Notes	Example
Connection	The Bynder connection to use.
Collection Description	The description of the collection to create	Official company logo for external use, approved by marketing.
Collection Name	The name of the collection to create	Company Logo 2024

{
  "data": {
    "message": "Created",
    "statuscode": 201
  }
}

Create Job

Create a new job | key: createJob

Input	Notes	Example
Accountable ID	Id of the user responsible for the job	00000000-0000-0000-0000000000000000
Data	Additional data to create the job
Campaign ID	Id of the campaign the job is part of	00000000-0000-0000-0000000000000000
Connection	The Bynder connection to use.
Description	The description of the job	Official company logo for external use, approved by marketing.
Name	The name of the job	Company Logo 2024
Preset ID	Id of the preset the job should be created from	00000000-0000-0000-0000000000000000

{
  "data": {
    "name": "Job Example",
    "description": "Job Description",
    "deadline": "2018-09-29",
    "campaignID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
    "accountableID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
    "presetID": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
    "jobMetaproperties": {
      "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
    },
    "stages": [
      {
        "description": "Awesome description",
        "preset_stage_id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
        "name": "Review",
        "responsibleID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
        "deadline": "2018-09-29"
      },
      {
        "description": "Stage description",
        "preset_stage_id": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234",
        "name": "Approval",
        "responsibleGroupID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
        "deadline": "2018-09-29"
      }
    ]
  }
}

Create User

Create a new user | key: createUser

Input	Notes	Example
Data	Additional fields to include in the request body as a JSON object.
Connection	The Bynder connection to use.
Email	The email address used to identify and authenticate the user.	john.doe@example.com
First Name	The first name of the user.	John
Last Name	The last name of the user.	Doe
Password	The password used to authenticate the user.	p@ssw0rd-example
Profile ID	The unique identifier of the security profile that determines the user's access rights. Retrieve available profiles using the List Security Profiles action.	00000000-0000-0000-0000000000000000
Username	The username for login. If not defined, the email address is used as the username.	user123

{
  "data": {
    "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "username": "jane.smith"
  }
}

Delete Asset

Delete an existing asset | key: deleteAsset

Input	Notes	Example
Connection	The Bynder connection to use.
ID	The unique identifier of the resource to retrieve.	00000000-0000-0000-0000000000000000

{
  "data": {}
}

Delete Asset Metaproperty Options

Remove metaproperty options from an asset | key: deleteAssetMetapropertyOptions

Input	Notes	Example
Asset ID	Id of the asset.	00000000-0000-0000-0000000000000000
Connection	The Bynder connection to use.
Metaproperty ID	The unique identifier of the metaproperty from which to add options.	00000000-0000-0000-0000000000000000
Metaproperty Options IDs	The list of metaproperty option IDs to add to the asset.	00000000-0000-0000-0000000000000000

{
  "data": {}
}

Delete Campaign

Delete an existing campaign | key: deleteCampaign

Input	Notes	Example
Connection	The Bynder connection to use.
Campaign ID	The ID of the campaign to delete	00000000-0000-0000-0000000000000000

{
  "data": {}
}

Delete Collection

Delete an existing collection | key: deleteCollection

Input	Notes	Example
Connection	The Bynder connection to use.
Collection ID	The ID of the collection to delete	00000000-0000-0000-0000000000000000

{
  "data": {}
}

Delete Job

Delete an existing job | key: deleteJob

Input	Notes	Example
Connection	The Bynder connection to use.
Job ID	The ID of the job to delete	00000000-0000-0000-0000000000000000

{
  "data": {}
}

Delete User

Remove an existing user | key: deleteUser

Input	Notes	Example
Connection	The Bynder connection to use.
ID	The unique identifier of the resource to retrieve.	00000000-0000-0000-0000000000000000

Download Specific Asset Item

Download an specific asset item | key: downloadSpecificAssetItem

Input	Notes	Example
Connection	The Bynder connection to use.
Hash	When true, treats the item ID as a hashed item ID.	false
Asset ID	The id of the asset you’d like to download a item of.	00000000-0000-0000-0000000000000000
Item ID	The id of the specific asset item you’d like to download.	00000000-0000-0000-0000000000000000

{
  "data": {
    "disclaimer": "<p>1. The photographs and video in the mediabank are to be used by anyone and everyone.</p>",
    "s3_file": "https://bynder-public-us-east-1.s3.amazonaws.com/temp/download-token/asset.jpg"
  }
}

Finalize Complete Upload

Finalize a completely uploaded file. | key: finaliseCompleteUpload

Input	Notes	Example
Chunks	Total number of chunks uploaded.	1
Connection	The Bynder connection to use.
ID	ID of the upload.	T3.fS5.5HPhtYFtm2b_.e7wVe910tL5XQutKw1jkMqlP5cPQVyZkOZxZ9lJiGUk4FIw6M0CFZ3xogTWrm.GPI2p2CaglQcAS5aH37zT_vHJnbtkebYbheXIQc_.M_6hM
Original Filename	Filename including special characters to be displayed in Bynder.	Logo.png
S3 Filename	Base location of the uploaded file.	api_uploads/159D8D4B-B981-49B8-BF0569FD144CB359/A29FABF0-26B8-44BF-890920E4C09E7C11/Logo.png
Target ID	The target ID returned by the initialise upload call.	final/00000000-0000-0000-0000000000000000/Logo.png

{
  "data": {
    "output": "final/C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012/",
    "batchId": "D4E5F6A7-B8C9-0123-D4E5F6A7B8C90123",
    "file": {
      "bucket": "bynder-public-eu-central-1",
      "path": "final/C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012/IMG_1874.JPG",
      "type": "s3"
    },
    "filename": "final/C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012/IMG_1874.JPG",
    "importId": "E5F6A7B8-C9D0-1234-E5F6A7B8C9D01234",
    "locationType": "s3",
    "success": 1
  }
}

Finalize Complete Upload And Save As New Asset Additional

Finalize a completely uploaded file and save as a new asset additional. | key: finaliseCompleteUploadAndSaveAsNewAsset

Input	Notes	Example
Asset ID	Asset id to which to save the new additional.	00000000-0000-0000-0000000000000000
Chunks	Total number of chunks uploaded.	1
Connection	The Bynder connection to use.
S3 Filename	Base location of the uploaded file or filename result from the last upload chunk action.	api_uploads/159D8D4B-B981-49B8-BF0569FD144CB359/A29FABF0-26B8-44BF-890920E4C09E7C11/Logo.png/p{chunks}
Target ID	The target ID returned by the initialise upload call.	final/00000000-0000-0000-0000000000000000/Logo.png
ID	ID of the upload.	T3.fS5.5HPhtYFtm2b_.e7wVe910tL5XQutKw1jkMqlP5cPQVyZkOZxZ9lJiGUk4FIw6M0CFZ3xogTWrm.GPI2p2CaglQcAS5aH37zT_vHJnbtkebYbheXIQc_.M_6hM

{
  "data": {
    "itemId": "F6A7B8C9-D0E1-2345-F6A7B8C9D0E12345"
  }
}

Generate Dynamic Asset Transformation

Generate a derivative on the fly with a transformation (such as cropping, scaling, filling) applied to it | key: generateDynamicTransformation

Input	Notes	Example
Connection	The Bynder connection to use.
Focus Point	The focus point as an x,y coordinate with values between 0 and 1. This serves as the center point for image operations.	0.5,0.25
Format	The format of the served image. Accepted values are jpg or png, which overrides the default webP format.	jpg
ID	The unique identifier of the resource to retrieve.	00000000-0000-0000-0000000000000000
IO	The operation(s) performed on the image before it is served to the client. Multiple operations can be specified by using this parameter several times.	transform:crop,width:100,height:200
Name	The display name of the asset. The asset will have no name if this is left empty.	Company Logo 2024
Quality	The image quality, ranging from 1 to 100. Has no effect when the format is set to png.	75

{
  "data": {}
}

Get Account Information

Retrieve information on current account | key: getAccountInformation

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "data": {
    "availableLanguages": [
      "nl_NL",
      "en_GB",
      "en_US",
      "fr_FR",
      "de_DE",
      "it_IT",
      "es_ES",
      "pl_PL"
    ],
    "defaultLanguage": "en_US",
    "name": "Bynder",
    "timeZone": "Europe/Amsterdam",
    "isOpenImageBank": false
  }
}

Get Asset

Retrieve a specific asset | key: getAsset

Input	Notes	Example
Connection	The Bynder connection to use.
ID	The unique identifier of the resource to retrieve.	00000000-0000-0000-0000000000000000
Stats	When true, includes information about views and downloads.	false
Versions	When true, includes information about the different asset media items including versions.	false

{
  "data": {
    "dateModified": "2017-03-09T12:09:29Z",
    "propertyOptions": [
      "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
      "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
    ],
    "type": "image",
    "brandId": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
    "fileSize": 3895890,
    "id": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
    "height": 3301,
    "description": "Beautiful grassland picture",
    "idHash": "02c3c00b6388a63f",
    "name": "Grassland",
    "tags": [
      "2014",
      "nature"
    ],
    "orientation": "landscape",
    "width": 4951,
    "datePublished": "2017-03-07T14:28:56Z",
    "copyright": "",
    "extension": [
      "jpeg"
    ],
    "userCreated": "Jane Smith",
    "dateCreated": "2017-03-07T14:28:57Z",
    "archive": 0,
    "property_limitedrights": "Specific rights",
    "watermarked": 0,
    "limited": 0,
    "isPublic": 0,
    "thumbnails": {
      "mini": "https://d2csxpduxe849s.cloudfront.net/media/example/mini/grassland.jpg",
      "webimage": "https://d2csxpduxe849s.cloudfront.net/media/example/webimage/grassland.jpg",
      "thul": "https://d2csxpduxe849s.cloudfront.net/media/example/thul/grassland.jpg"
    },
    "transformBaseUrl": "https://example.bynder.com/transform/D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123/Grassland"
  }
}

Get Campaign

Retrieve a specific campaign | key: getCampaign

Input	Notes	Example
Connection	The Bynder connection to use.
Campaign ID	The ID of the campaign to retrieve	00000000-0000-0000-0000000000000000

{
  "data": {
    "dateStart": "2017-02-01T00:00:00+00:00",
    "description": "Campaign example",
    "responsibleID": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "dateModified": "2017-01-10T07:43:12+00:00",
    "dateCreated": "2017-01-10T07:43:12+00:00",
    "ID": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
    "presetID": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
    "deadline": "2017-03-03T00:00:00",
    "createdByID": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "accountID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
    "closed": false,
    "key": "excp",
    "name": "Example campaign",
    "thumbnailURL": "https://bynder-public-eu-central-1.s3.eu-central-1.amazonaws.com:443/workflow/campaign/988BBB04-F0E2-4A28-B5F892890849BAFE/FEE78434-649A-449B-A62A1C6C6D59CAC3/500x500.jpg",
    "campaignMetaproperties": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234"
  }
}

Get Closest S3 Upload Endpoint

Retrieve the closest S3 upload endpoint | key: getClosestS3Endpoint

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "data": "https://bynder-public-eu-central-1.s3.amazonaws.com/"
}

Get Collection

Retrieve a specific collection | key: getCollection

Input	Notes	Example
Connection	The Bynder connection to use.
Collection ID	The ID of the collection to retrieve	00000000-0000-0000-0000000000000000

{
  "data": {
    "userId": "A1B2C3D4-E5F6-7890-A1B2C3D4E5F67890",
    "dateModified": "March, 08 2017 14:17:37 +0000",
    "filename": "collection_1",
    "dateCreated": "March, 01 2017 10:49:12 +0000",
    "collectionCount": 2,
    "id": "B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901",
    "name": "Collection 1",
    "cover": {
      "thumbnail": "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-thumb.jpg",
      "thumbnails": [
        "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-1.jpg",
        "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-2.jpg",
        "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-3.jpg"
      ],
      "large": "https://d2csxpduxe849s.cloudfront.net/media/example/large/collection1.jpg"
    },
    "user": {
      "id": "A1B2C3D4-E5F6-7890-A1B2C3D4E5F67890",
      "name": "John Doe"
    },
    "description": "Collection 1 with various assets.",
    "IsPublic": 1
  }
}

Get Current User

Retrieve the current user | key: getCurrentUser

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "data": {
    "phoneNumber": "+1 5551234567",
    "profileId": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
    "lastLogin": "2017-03-10T15:42:03Z",
    "department": "Development",
    "job": "Developer",
    "state": "",
    "firstname": "John",
    "city": "Amsterdam",
    "infix": "",
    "timeZone": "Europe/Amsterdam",
    "username": "jane.smith",
    "email": "jane.smith@example.com",
    "persisted": true,
    "legalEntity": "",
    "county": "",
    "postalCode": "",
    "language": "en_GB",
    "country": "Netherlands",
    "costCenter": "",
    "groups": [
      {
        "name": "Bynder",
        "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
      },
      {
        "name": "Product",
        "id": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123"
      }
    ],
    "lastname": "Smith",
    "cellphoneNumber": "",
    "employeeNumber": "",
    "departmentCode": "",
    "gender": "U",
    "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "companyName": "Bynder",
    "active": true,
    "isSSOOnly": false,
    "address": "",
    "terms": "Digital Asset Management System Terms and Conditions <br/>\n<br/>\n  Overview<br/><br/>\n  All assets are free to use as long as these terms and conditions and license rules are followed.\nAll assets can not be used in paid advertising without the permission of Bynder.<br/><br/>"
  }
}

Get Job

Retrieve a job by ID | key: getJob

Input	Notes	Example
Connection	The Bynder connection to use.
Job ID	The ID of the job to retrieve	00000000-0000-0000-0000000000000000

{
  "data": {
    "job_stages": [
      {
        "position": 1,
        "status": "Approved",
        "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
      },
      {
        "position": 2,
        "status": "Active",
        "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
      },
      {
        "position": 3,
        "status": "Idle",
        "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
      }
    ],
    "dateModified": "2017-03-30T11:43:19+00:00",
    "presetID": null,
    "createdByID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
    "job_next_stage": {
      "position": 3,
      "status": "Idle",
      "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
    },
    "id": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234",
    "description": "",
    "accountableID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
    "basedOnPreset": false,
    "dateCreated": "2017-03-30T11:42:30+00:00",
    "job_active_stage": {
      "position": 2,
      "status": "Active",
      "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
    },
    "deadline": null,
    "name": "Test API",
    "campaignID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
    "job_previous_stage": {
      "position": 1,
      "status": "Approved",
      "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
    }
  }
}

Get Job Preset

Retrieve a job preset by ID | key: getJobPreset

Input	Notes	Example
Connection	The Bynder connection to use.
Job preset ID	The ID of the job preset to retrieve	00000000-0000-0000-0000000000000000

{
  "data": {
    "preset": {
      "ID": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
      "name": "API name",
      "wf_uuid": "A7B8C9D0-E1F2-3456-A7B8-C9D0E1F23456",
      "ftp_settings": {},
      "presetstages": [
        {
          "description": "",
          "ID": "B8C9D0E1-F2A3-4567-B8C9-D0E1F2A34567",
          "name": "Revision Stage",
          "position": 1,
          "editableBy": "all",
          "restrictToGroupID": null,
          "type": "download",
          "responsibleID": null,
          "responsibleGroupID": null
        }
      ]
    }
  }
}

Get Media of Job

Retrieve media attached to an existing job | key: getMediaOfJob

Input	Notes	Example
Connection	The Bynder connection to use.
Job ID	The ID of the job to retrieve	00000000-0000-0000-0000000000000000

{
  "data": [
    {
      "original_url": "https://example.bynder.com/media/original/brand-logo.png",
      "filename": "brand-logo.png",
      "orientation": "square",
      "status": "AwaitingApproval",
      "dateCreated": "2021-05-12T08:48:01+00:00",
      "dateModified": "2021-05-12T08:51:22+00:00",
      "responsible_name": "Jane Smith",
      "version": 1,
      "uploader_name": "Jane Smith",
      "versionParentID": null,
      "id": "B8C9D0E1-F2A3-4567-B8C9-D0E1F2A34567",
      "previews": [
        {
          "type": "thumbnail",
          "url": "https://example.bynder.com/media/preview/brand-logo-thumb.png"
        },
        {
          "type": "preview",
          "url": "https://example.bynder.com/media/preview/brand-logo-preview.png"
        },
        {
          "type": "activity",
          "url": "https://example.bynder.com/media/preview/brand-logo-activity.png"
        }
      ],
      "sub_versions": [
        {
          "original_url": "https://example.bynder.com/media/original/brand-logo-v2.png",
          "filename": "brand-logo.png",
          "orientation": "square",
          "status": "AwaitingApproval",
          "dateCreated": "2021-05-13T08:48:01+00:00",
          "dateModified": "2021-05-13T08:51:22+00:00",
          "responsible_name": "Jane Smith",
          "version": 2,
          "uploader_name": "Jane Smith",
          "versionParentID": "B8C9D0E1-F2A3-4567-B8C9-D0E1F2A34567",
          "id": "C9D0E1F2-A3B4-5678-C9D0-E1F2A3B45678",
          "previews": [
            {
              "type": "thumbnail",
              "url": "https://example.bynder.com/media/preview/brand-logo-v2-thumb.png"
            },
            {
              "type": "preview",
              "url": "https://example.bynder.com/media/preview/brand-logo-v2-preview.png"
            },
            {
              "type": "activity",
              "url": "https://example.bynder.com/media/preview/brand-logo-v2-activity.png"
            }
          ],
          "sub_versions": []
        }
      ]
    }
  ]
}

Get Order

Retrieve an existing order | key: getOrder

Input	Notes	Example
Connection	The Bynder connection to use.
Order ID	The ID of the order to retrieve. Either id or orderNumber is required	00000000-0000-0000-0000000000000000
Order Number	The order number of the order to retrieve. Either id or orderNumber is required	00000000-0000-0000-0000000000000000

{
  "data": [
    {
      "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
      "orderId": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
      "product": {
        "id": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
        "name": "Train the trainer product",
        "description": "This is such a nice product!",
        "isFeatured": false,
        "product_number": "999999999",
        "supplier_number": null,
        "size_height": 1,
        "size_width": 1,
        "size_depth": 1,
        "weight": 1,
        "min_quantity": 1,
        "max_quantity": 10,
        "default_quantity": 1,
        "datecreated": "2016-08-10T12:14:16+00:00",
        "isActive": true,
        "product_type": "print",
        "product_package": "unit",
        "countries": null,
        "sku": "1",
        "step": 1,
        "display_length_unit": "cm",
        "isFree": false,
        "pages": null,
        "language": null,
        "supplier_version_specifier": null,
        "isShipping": false
      },
      "referenceId": "999999999",
      "name": "Train the trainer product",
      "description": "",
      "itemPrice": 0.2333,
      "quantity": 3,
      "supplier": null,
      "customerReference": null,
      "metaproperties": null
    }
  ]
}

Get Order Info

Retrieve information on an order | key: getOrderInfo

Input	Notes	Example
Connection	The Bynder connection to use.
Order ID	The ID of the order to retrieve	00000000-0000-0000-0000000000000000

{
  "data": {
    "id": "A1B2C3D4-E5F6-7890-A1B2C3D4E5F67890",
    "dateCreated": "2015-06-01T08:36:18Z",
    "status": "IN_PRODUCTION",
    "orderReference": "NL0456"
  }
}

Get Security Profile

Retrieve a specified security profile | key: getSecurityProfile

Input	Notes	Example
Connection	The Bynder connection to use.
ID	The unique identifier of the resource to retrieve.	00000000-0000-0000-0000000000000000

{
  "data": {
    "name": "Internal Limited user",
    "id": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
    "roles": [
      "MEDIADOWNLOAD",
      "SHARING",
      "MEDIAOVERVIEW",
      "MEDIAHIGHRES"
    ]
  }
}

Get User

Retrieve a specified user | key: getUser

Input	Notes	Example
Connection	The Bynder connection to use.
ID	The ID or username of the user to retrieve	00000000-0000-0000-0000000000000000

{
  "data": {
    "phoneNumber": "+1 5551234567",
    "profileId": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
    "lastLogin": "2017-03-10T15:42:03Z",
    "department": "Development",
    "job": "Developer",
    "state": "",
    "firstname": "John",
    "city": "Amsterdam",
    "infix": "",
    "timeZone": "Europe/Amsterdam",
    "username": "jane.smith",
    "email": "jane.smith@example.com",
    "persisted": true,
    "legalEntity": "",
    "county": "",
    "postalCode": "",
    "language": "en_GB",
    "country": "Netherlands",
    "costCenter": "",
    "groups": [
      {
        "name": "Bynder",
        "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
      },
      {
        "name": "Product",
        "id": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123"
      }
    ],
    "lastname": "Smith",
    "cellphoneNumber": "",
    "employeeNumber": "",
    "departmentCode": "",
    "gender": "U",
    "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "companyName": "Bynder",
    "active": true,
    "isSSOOnly": false,
    "address": "",
    "terms": "Digital Asset Management System Terms and Conditions <br/>\n<br/>\n  Overview<br/><br/>\n  All assets are free to use as long as these terms and conditions and license rules are followed.\nAll assets can not be used in paid advertising without the permission of Bynder.<br/><br/>"
  }
}

Initialize Upload

Initialize a new file upload. | key: initialiseUpload

Input	Notes	Example
Connection	The Bynder connection to use.
Filename	Filename of new upload (extension required).	image.jpeg

{
  "data": {
    "s3file": {
      "uploadid": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
      "targetid": "final/B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901/image.jpeg"
    },
    "s3_filename": "pluploads/api/B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901/image.jpeg",
    "target_key": "pluploads/api/B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901/image.jpeg",
    "multipart_params": {
      "acl": "private",
      "success_action_status": "201",
      "Content-Type": "image/*",
      "key": "pluploads/api/B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901/image.jpeg",
      "Policy": "AWS_S3_POLICY",
      "X-Amz-Signature": "AWS_S3_SIGNATURE",
      "x-amz-credential": "AWS_S3_AUTH",
      "x-amz-algorithm": "AWS4-HMAC-SHA256",
      "x-amz-date": "20160216T100755Z"
    }
  }
}

List Assets

Retrieve all assets | key: listAssets

Input	Notes	Example
Connection	The Bynder connection to use.
Count	When true, the response includes count results. This parameter overrides the total parameter when set to true.	false
Extra Parameters	Additional query parameters to include in the request.	{"keyword": "logo"}
Fetch All	When true, automatically fetches all pages of results using pagination.	false
Limit	Maximum number of results. Maximum: 1000. Default: 50	100
Page	The page number to retrieve (starts at 1).	1
Total	When true, the response includes the total count of results.	false

{
  "data": [
    {
      "dateModified": "2017-03-09T12:09:29Z",
      "propertyOptions": [
        "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
        "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
      ],
      "type": "image",
      "brandId": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
      "fileSize": 3895890,
      "id": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "height": 3301,
      "description": "Beautiful grassland picture",
      "idHash": "02c3c00b6388a63f",
      "name": "Grassland",
      "tags": [
        "2014",
        "nature"
      ],
      "orientation": "landscape",
      "width": 4951,
      "datePublished": "2017-03-07T14:28:56Z",
      "copyright": "",
      "extension": [
        "jpeg"
      ],
      "userCreated": "Jane Smith",
      "dateCreated": "2017-03-07T14:28:57Z",
      "archive": 0,
      "property_limitedrights": "Specific rights",
      "watermarked": 0,
      "limited": 0,
      "isPublic": 0,
      "thumbnails": {
        "mini": "https://d2csxpduxe849s.cloudfront.net/media/example/mini/grassland.jpg",
        "webimage": "https://d2csxpduxe849s.cloudfront.net/media/example/webimage/grassland.jpg",
        "thul": "https://d2csxpduxe849s.cloudfront.net/media/example/thul/grassland.jpg"
      },
      "transformBaseUrl": "https://example.bynder.com/transform/D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123/Grassland"
    },
    {
      "dateModified": "2015-07-28T10:46:59Z",
      "propertyOptions": [
        "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
        "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
      ],
      "type": "video",
      "brandId": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
      "fileSize": 63973541,
      "id": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234",
      "height": 0,
      "description": "",
      "idHash": "536f140e0ba62e46",
      "name": "App Instruction Video",
      "tags": [
        "tutorial videos",
        "tutorial",
        "video"
      ],
      "orientation": "landscape",
      "width": 0,
      "datePublished": "2015-07-23T10:46:00Z",
      "copyright": "",
      "extension": [
        "mp4"
      ],
      "userCreated": "",
      "dateCreated": "2015-07-23T17:20:19Z",
      "archive": 0,
      "property_assettype": [
        "video"
      ],
      "watermarked": 0,
      "limited": 1,
      "videoPreviewURLs": [
        "https://d2csxpduxe849s.cloudfront.net/media/example/video/app-instruction.webm",
        "https://d2csxpduxe849s.cloudfront.net/media/example/video/app-instruction.mp4"
      ],
      "thumbnails": {
        "mini": "https://d2csxpduxe849s.cloudfront.net/media/example/mini/app-instruction.jpg",
        "webimage": "https://d2csxpduxe849s.cloudfront.net/media/example/webimage/app-instruction.jpg",
        "67E391FA": "https://d2csxpduxe849s.cloudfront.net/media/example/67E391FA/app-instruction.jpg",
        "thul": "https://d2csxpduxe849s.cloudfront.net/media/example/thul/app-instruction.jpg"
      },
      "isPublic": 1,
      "original": "https://d2csxpduxe849s.cloudfront.net/media/example/original/app-instruction.mp4",
      "transformBaseUrl": "https://example.bynder.com/transform/E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234/AppInstructionVideo"
    }
  ]
}

List Brands

Retrieve all brands | key: listBrands

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "data": [
    {
      "image": "https://d2csxpduxe849s.cloudfront.net/media/example/brands/brand-portal-logo.png",
      "name": "Bynder Brand Portal",
      "id": "A1B2C3D4-E5F6-7890-A1B2C3D4E5F67890",
      "description": "",
      "subBrands": [
        {
          "id": "B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901",
          "description": "",
          "name": "Sub Portal One",
          "image": ""
        },
        {
          "id": "C3D4E5F6-A7B8-9012-C3D4E5F6A7B89012",
          "description": "",
          "name": "Sub Portal Two",
          "image": ""
        }
      ]
    },
    {
      "image": "https://d2csxpduxe849s.cloudfront.net/media/example/brands/secondary-brand-logo.png",
      "name": "Byndy Brand Portal",
      "id": "D4E5F6A7-B8C9-0123-D4E5F6A7B8C90123",
      "description": "",
      "subBrands": []
    }
  ]
}

List Campaigns

Retrieve all campaigns | key: listCampaigns

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "data": [
    {
      "dateStart": "2017-02-01T00:00:00+00:00",
      "description": "Campaign example",
      "responsibleID": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
      "dateModified": "2017-01-10T07:43:12+00:00",
      "dateCreated": "2017-01-10T07:43:12+00:00",
      "ID": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
      "presetID": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
      "deadline": "2017-03-03T00:00:00",
      "createdByID": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
      "accountID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "closed": false,
      "key": "excp",
      "name": "Example campaign",
      "thumbnailURL": "https://bynder-public-eu-central-1.s3.eu-central-1.amazonaws.com:443/workflow/campaign/988BBB04-F0E2-4A28-B5F892890849BAFE/FEE78434-649A-449B-A62A1C6C6D59CAC3/500x500.jpg",
      "campaignMetaproperties": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234"
    },
    {
      "dateStart": "2017-04-01T00:00:00+00:00",
      "description": "Spring Campaign 2017",
      "responsibleID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
      "dateModified": "2017-03-15T09:22:00+00:00",
      "dateCreated": "2017-03-15T09:22:00+00:00",
      "ID": "A7B8C9D0-E1F2-3456-A7B8-C9D0E1F23456",
      "deadline": "2017-05-01T00:00:00",
      "createdByID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
      "accountID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "presetID": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012",
      "closed": false,
      "key": "spr17",
      "name": "Spring Campaign 2017",
      "thumbnailURL": "https://bynder-public-eu-central-1.s3.eu-central-1.amazonaws.com:443/workflow/campaign/988BBB04-F0E2-4A28-B5F892890849BAFE/FEE78434-649A-449B-A62A1C6C6D59CAC3/500x500.jpg",
      "campaignMetaproperties": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234"
    }
  ]
}

List Collections

Retrieve all collections | key: listCollections

Input	Notes	Example
Connection	The Bynder connection to use.
Count	When true, the response includes count results. This parameter overrides the total parameter when set to true.	false
Extra Parameters	Additional query parameters to include in the request.	{"keyword": "logo"}
Fetch All	When true, automatically fetches all pages of results using pagination.	false
Limit	The maximum number of results to return per page.	100
Page	The page number to retrieve (starts at 1).	1

{
  "data": {
    "collections": [
      {
        "userId": "A1B2C3D4-E5F6-7890-A1B2C3D4E5F67890",
        "dateModified": "March, 08 2017 14:17:37 +0000",
        "filename": "collection_1",
        "dateCreated": "March, 01 2017 10:49:12 +0000",
        "collectionCount": 2,
        "id": "B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901",
        "name": "Collection 1",
        "cover": {
          "thumbnail": "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-thumb.jpg",
          "thumbnails": [
            "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-1.jpg",
            "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-2.jpg",
            "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection1-3.jpg"
          ],
          "large": "https://d2csxpduxe849s.cloudfront.net/media/example/large/collection1.jpg"
        },
        "user": {
          "id": "A1B2C3D4-E5F6-7890-A1B2C3D4E5F67890",
          "name": "John Doe"
        },
        "description": "Collection 1 with various assets.",
        "IsPublic": 1
      },
      {
        "userId": "C3D4E5F6-A7B8-9012-C3D4E5F6A7B89012",
        "dateModified": "March, 10 2017 07:57:18 +0000",
        "filename": "collection_2",
        "dateCreated": "October, 30 2014 13:54:00 +0000",
        "collectionCount": 4,
        "id": "D4E5F6A7-B8C9-0123-D4E5F6A7B8C90123",
        "name": "Collection 2",
        "cover": {
          "thumbnail": "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection2-thumb.jpg",
          "thumbnails": [
            "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection2-1.jpg",
            "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection2-2.jpg",
            "https://d2csxpduxe849s.cloudfront.net/media/example/thumbnails/collection2-3.jpg"
          ],
          "large": "https://d2csxpduxe849s.cloudfront.net/media/example/large/collection2.jpg"
        },
        "user": {
          "id": "C3D4E5F6-A7B8-9012-C3D4E5F6A7B89012",
          "name": "Jane Doe"
        },
        "description": "Collection 2 with various assets.",
        "IsPublic": 0
      }
    ],
    "count": 151
  }
}

List Jobs

Retrieve all jobs | key: listJobs

Input	Notes	Example
Connection	The Bynder connection to use.
Extra Parameters	Additional query parameters to include in the request.	{"keyword": "logo"}
Limit	The maximum number of results to return per page.	100
Page	The page number to retrieve (starts at 1).	1

{
  "data": [
    {
      "job_stages": [
        {
          "position": 1,
          "status": "Approved",
          "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
        },
        {
          "position": 2,
          "status": "Active",
          "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
        },
        {
          "position": 3,
          "status": "Idle",
          "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
        }
      ],
      "dateModified": "2017-03-30T11:43:19+00:00",
      "presetID": null,
      "jobMetaproperties": {
        "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890": "City"
      },
      "createdByID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "job_next_stage": {
        "position": 3,
        "status": "Idle",
        "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
      },
      "id": "A7B8C9D0-E1F2-3456-A7B8-C9D0E1F23456",
      "description": "",
      "accountableID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "basedOnPreset": false,
      "dateCreated": "2017-03-30T11:42:30+00:00",
      "job_active_stage": {
        "position": 2,
        "status": "Active",
        "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
      },
      "deadline": null,
      "name": "Test API",
      "campaignID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
      "job_previous_stage": {
        "position": 1,
        "status": "Approved",
        "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
      }
    },
    {
      "job_stages": [
        {
          "position": 1,
          "status": "Approved",
          "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
        },
        {
          "position": 2,
          "status": "Active",
          "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
        },
        {
          "position": 3,
          "status": "Idle",
          "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
        }
      ],
      "dateModified": "2017-03-30T11:43:19+00:00",
      "presetID": null,
      "createdByID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "job_next_stage": {
        "position": 3,
        "status": "Idle",
        "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
      },
      "id": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234",
      "description": "",
      "accountableID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "basedOnPreset": false,
      "dateCreated": "2017-03-30T11:42:30+00:00",
      "job_active_stage": {
        "position": 2,
        "status": "Active",
        "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
      },
      "deadline": null,
      "name": "Test API",
      "campaignID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
      "job_previous_stage": {
        "position": 1,
        "status": "Approved",
        "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
      }
    }
  ],
  "headers": {}
}

List Jobs By Campaign

Retrieve jobs tied to a campaign | key: listJobsByCampaign

Input	Notes	Example
Connection	The Bynder connection to use.
Extra Parameters	Additional query parameters to include in the request.	{"keyword": "logo"}
Campaign ID	The ID of the campaign to retrieve jobs for	00000000-0000-0000-0000000000000000
Limit	The maximum number of results to return per page.	100
Page	The page number to retrieve (starts at 1).	1

{
  "data": [
    {
      "job_stages": [
        {
          "position": 1,
          "status": "Approved",
          "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
        },
        {
          "position": 2,
          "status": "Active",
          "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
        },
        {
          "position": 3,
          "status": "Idle",
          "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
        }
      ],
      "dateModified": "2017-03-30T11:43:19+00:00",
      "presetID": null,
      "jobMetaproperties": {
        "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890": "City"
      },
      "createdByID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "job_next_stage": {
        "position": 3,
        "status": "Idle",
        "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
      },
      "id": "A7B8C9D0-E1F2-3456-A7B8-C9D0E1F23456",
      "description": "",
      "accountableID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "basedOnPreset": false,
      "dateCreated": "2017-03-30T11:42:30+00:00",
      "job_active_stage": {
        "position": 2,
        "status": "Active",
        "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
      },
      "deadline": null,
      "name": "Test API",
      "campaignID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
      "job_previous_stage": {
        "position": 1,
        "status": "Approved",
        "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
      }
    },
    {
      "job_stages": [
        {
          "position": 1,
          "status": "Approved",
          "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
        },
        {
          "position": 2,
          "status": "Active",
          "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
        },
        {
          "position": 3,
          "status": "Idle",
          "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
        }
      ],
      "dateModified": "2017-03-30T11:43:19+00:00",
      "presetID": null,
      "createdByID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "job_next_stage": {
        "position": 3,
        "status": "Idle",
        "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
      },
      "id": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234",
      "description": "",
      "accountableID": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123",
      "basedOnPreset": false,
      "dateCreated": "2017-03-30T11:42:30+00:00",
      "job_active_stage": {
        "position": 2,
        "status": "Active",
        "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901"
      },
      "deadline": null,
      "name": "Test API",
      "campaignID": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
      "job_previous_stage": {
        "position": 1,
        "status": "Approved",
        "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
      }
    }
  ],
  "headers": {}
}

List Metaproperties

Retrieve all metaproperties. | key: listMetaproperties

Input	Notes	Example
Connection	The Bynder connection to use.
Count	Indicates whether or not the response should include asset count results for metaproperty-options.	false
IDs	The list of metaproperty IDs to retrieve. Returns a metaproperty for each matching ID.	00000000-0000-0000-0000000000000000
Options	When true, the response includes the metaproperty options of each metaproperty.	false
Type	The asset types to filter count results by. Only applicable when the count parameter is set to true.

{
  "data": {
    "Colours": {
      "isMultiselect": 0,
      "isMultifilter": 0,
      "isRequired": 0,
      "isMainfilter": 1,
      "isFilterable": 1,
      "isApiField": 1,
      "isDisplayField": 0,
      "isDrilldown": 0,
      "isEditable": 1,
      "name": "colours",
      "label": "Colours",
      "zindex": 16,
      "id": "A1B2C3D4-E5F6-7890-A1B2C3D4E5F67890",
      "type": "sidebar",
      "showInListView": 1,
      "showInGridView": 0,
      "showInDuplicateView": 0,
      "useDependencies": 0,
      "options": [
        {
          "displayLabel": "Yellow",
          "date": "February, 15 2017 14:54:58 +0000",
          "pregeneratedZipFileSize": 0,
          "linkedOptionIds": [],
          "isSelectable": 1,
          "zindex": 1,
          "product_suffix": "",
          "name": "yellow",
          "id": "B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901",
          "active": 1,
          "label": "Yellow",
          "labels": {
            "nl_NL": "Geel",
            "en_US": "Yellow"
          },
          "descriptions": {},
          "description": "",
          "hideByDefault": 0,
          "image": "https://d2csxpduxe849s.cloudfront.net/media/example/metaproperties/yellow-swatch.png"
        },
        {
          "displayLabel": "Red",
          "date": "February, 15 2017 15:50:55 +0000",
          "pregeneratedZipFileSize": 0,
          "linkedOptionIds": [],
          "isSelectable": 1,
          "zindex": 1,
          "product_suffix": "",
          "name": "red",
          "id": "C3D4E5F6-A7B8-9012-C3D4E5F6A7B89012",
          "active": 1,
          "label": "Red",
          "labels": {
            "nl_NL": "Rood",
            "en_US": "Red"
          },
          "descriptions": {},
          "description": "",
          "hideByDefault": 0,
          "image": "https://d2csxpduxe849s.cloudfront.net/media/example/metaproperties/red-swatch.png"
        }
      ]
    },
    "Bob_button": {
      "isMultiselect": 0,
      "isMultifilter": 0,
      "isRequired": 0,
      "isMainfilter": 1,
      "isFilterable": 1,
      "isApiField": 1,
      "isDisplayField": 0,
      "isDrilldown": 0,
      "isEditable": 1,
      "name": "Bob_button",
      "label": "Bob_button",
      "zindex": 2,
      "id": "D4E5F6A7-B8C9-0123-D4E5F6A7B8C90123",
      "type": "button",
      "showInListView": 1,
      "showInGridView": 0,
      "showInDuplicateView": 0,
      "useDependencies": 0,
      "options": []
    }
  }
}

List Orders

Retrieve all orders. | key: listOrders

Input	Notes	Example
Connection	The Bynder connection to use.
Page	Offset page for results: return the N-th set of limit-results. Limit is currently hardcoded to 10.	1

{
  "data": [
    {
      "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
      "order_ref": "NA13334",
      "net_price": 0,
      "date_created": "2018-10-25T14:26:01+00:00",
      "username": "jane.smith@example.com",
      "account_name": "Bynder",
      "order_status": "In production",
      "currency_symbol": "8364"
    },
    {
      "id": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
      "order_ref": "US12774",
      "net_price": 79,
      "date_created": "2018-09-10T12:12:21+00:00",
      "username": "jane.smith@example.com",
      "account_name": "Bynder",
      "order_status": "Waiting for approval",
      "currency_symbol": "36"
    }
  ]
}

List Security Profiles

Retrieve all security profiles | key: listSecurityProfiles

Input	Notes	Example
Connection	The Bynder connection to use.

{
  "data": [
    {
      "name": "Internal Limited user",
      "id": "F6A7B8C9-D0E1-2345-F6A7-B8C9D0E12345",
      "roles": [
        "MEDIADOWNLOAD",
        "SHARING",
        "MEDIAOVERVIEW",
        "MEDIAHIGHRES"
      ]
    },
    {
      "name": "Content/Brand Manager",
      "id": "A7B8C9D0-E1F2-3456-A7B8-C9D0E1F23456",
      "roles": [
        "PUBLICCOLLECTIONS",
        "GROUPSHARING",
        "COLLECTIONS"
      ]
    }
  ]
}

List Users

Retrieve all users | key: listUsers

Input	Notes	Example
Connection	The Bynder connection to use.
Include Inactive	When true, includes inactive users in the list of results.	false
Limit	The maximum number of results to return per page.	100
Page	The page number to retrieve (starts at 1).	1

{
  "data": [
    {
      "email2": "john.doe@example.com",
      "salesrepId": "",
      "name": "David",
      "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
      "active": 1,
      "isSSOOnly": false,
      "username": "jane.smith",
      "email": "jane.smith@example.com",
      "profileId": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
      "groups": [
        {
          "name": "Bynder",
          "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
        },
        {
          "name": "Product",
          "id": "D4E5F6A7-B8C9-0123-D4E5-F6A7B8C90123"
        }
      ]
    },
    {
      "email2": "john.doe@example.com",
      "salesrepId": "",
      "name": "Jake",
      "id": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234",
      "active": 1,
      "isSSOOnly": true,
      "username": "jane.smith",
      "email": "jane.smith@example.com",
      "profileId": "B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901",
      "groups": [
        {
          "name": "Bynder",
          "id": "C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012"
        }
      ]
    }
  ],
  "headers": {}
}

Raw Request

Send raw HTTP request to Bynder | key: rawRequest

Input	Notes	Example
Connection	The Bynder connection to use.
Data	The HTTP body payload to send to the URL.	{"exampleKey": "Example Data"}
File Data	File Data to be sent as a multipart form upload.	[{key: "example.txt", value: "My File Contents"}]
File Data File Names	File names to apply to the file data inputs. Keys must match the file data keys above.
Form Data	The Form Data to be sent as a multipart form upload.	[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header	A list of headers to send with the request.	User-Agent: curl/7.64.1
Max Retry Count	The maximum number of retries to attempt. Specify 0 for no retries.	0
Method	The HTTP method to use.
Query Parameter	A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Response Type	The type of data you expect in the response. You can request json, text, or binary data.	json
Retry On All Errors	If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.	false
Retry Delay (ms)	The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.	0
Timeout	The maximum time that a client will await a response to its request	2000
URL	This is the URL to call.	Input the path only (/v4/media/), The base URL is already included (https://your-bynder-domain/api/). For example, to connect to https://your-bynder-domain/api/v4/media/, only /v4/media/ is entered in this field. e.g. /v4/media/
Use Exponential Backoff	Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.	false

Register Uploaded Chunk

Input	Notes	Example
Chunk Number	Number of the chunk that was uploaded.	1
Connection	The Bynder connection to use.
Filename	Location of the uploaded chunk.	api_uploads/00000000-0000-0000-0000000000000000/00000000-0000-0000-0000000000000000/Logo.png/p5
ID	ID of the upload.	T3.fS5.5HPhtYFtm2b_.e7wVe910tL5XQutKw1jkMqlP5cPQVyZkOZxZ9lJiGUk4FIw6M0CFZ3xogTWrm.GPI2p2CaglQcAS5aH37zT_vHJnbtkebYbheXIQc_.M_6hM
Target ID	The target ID returned by the initialise upload call.	final/00000000-0000-0000-0000000000000000/Logo.png

{
  "data": {
    "status": "ok"
  }
}

Retrieve Poll State

Poll processing state of finalized files | key: retrievePollState

Input	Notes	Example
Connection	The Bynder connection to use.
Items	Comma-separated import IDs of a finalized file, as returned by the finalize call.	00000000-0000-0000-0000000000000000

{
  "data": {
    "itemsDone": [
      "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890"
    ],
    "itemsFailed": [],
    "itemsRejected": []
  }
}

Save a New Asset

Save a completed upload as a new asset. | key: saveAsNewAsset

Input	Notes	Example
Data	Data of the new asset.
Brand ID	Brand id to save the asset to.	00000000-0000-0000-0000000000000000
Connection	The Bynder connection to use.
Copyright	Copyright information associated with the asset.	Copyright (c) Example corp
Description	A text description providing additional context about the asset.	Official company logo for external use, approved by marketing.
Import ID	Import id of a finalized and processed upload to be saved.	00000000-0000-0000-0000000000000000
Asset Name	Name of the new asset.	Logo

{
  "data": {
    "accessRequestId": "B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901",
    "mediaid": "C3D4E5F6-A7B8-9012-C3D4E5F6A7B89012",
    "batchId": "D4E5F6A7-B8C9-0123-D4E5F6A7B8C90123",
    "success": true,
    "mediaitems": [
      {
        "original": "final/B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901/image.jpg",
        "destination": "https://d2csxpduxe849s.cloudfront.net/media/example/original/image.jpg"
      },
      {
        "original": "final/B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901/thul-image.jpg",
        "destination": "https://d2csxpduxe849s.cloudfront.net/media/example/thul/image.jpg"
      },
      {
        "original": "final/B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901/mini-image.jpg",
        "destination": "https://d2csxpduxe849s.cloudfront.net/media/example/mini/image.jpg"
      }
    ]
  }
}

Save as a New Asset Version

Save a completed upload as a new asset version. | key: saveAsNewAssetVersion

Input	Notes	Example
Asset ID	Asset id for which to save the new version.	00000000-0000-0000-0000000000000000
Connection	The Bynder connection to use.
Import ID	Import id of a finalized and processed upload to be saved.	00000000-0000-0000-0000000000000000

{
  "data": {
    "accessRequestId": "B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901",
    "mediaid": "C3D4E5F6-A7B8-9012-C3D4E5F6A7B89012",
    "batchId": "D4E5F6A7-B8C9-0123-D4E5F6A7B8C90123",
    "success": true,
    "mediaitems": [
      {
        "original": "final/B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901/image.jpg",
        "destination": "https://d2csxpduxe849s.cloudfront.net/media/example/original/image.jpg"
      },
      {
        "original": "final/B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901/thul-image.jpg",
        "destination": "https://d2csxpduxe849s.cloudfront.net/media/example/thul/image.jpg"
      },
      {
        "original": "final/B2C3D4E5-F6A7-8901-B2C3D4E5F6A78901/mini-image.jpg",
        "destination": "https://d2csxpduxe849s.cloudfront.net/media/example/mini/image.jpg"
      }
    ]
  }
}

Share Collection

Share a collection | key: shareCollection

Input	Notes	Example
Data	Additional fields to include in the request body as a JSON object.
Collection Options	The access rights granted to recipients of the shared collection.
Connection	The Bynder connection to use.
Groups	Comma-separated list of group IDs to share the collection with. Required if recipients or profiles are empty.	00000000-0000-0000-0000000000000000
Collection ID	The ID of the collection to retrieve	00000000-0000-0000-0000000000000000
Profiles	Comma-separated list of profile IDs to share the collection with. Required if recipients or groups are empty.	00000000-0000-0000-0000000000000000
Recipients	Comma-separated email addresses of recipients to share the collection with. Required if groups or profiles are empty.	user1@bynder.com,user2@bynder.com

{
  "data": {
    "message": "Accepted",
    "statuscode": 202
  }
}

Update Asset

Edit an existing asset | key: updateAsset

Input	Notes	Example
Data	Additional fields to include in the request body as a JSON object.
Connection	The Bynder connection to use.
Copyright	Copyright information associated with the asset.	Copyright (c) Example corp
Description	A text description providing additional context about the asset.	Official company logo for external use, approved by marketing.
ID	The unique identifier of the resource to retrieve.	00000000-0000-0000-0000000000000000
Name	The display name of the asset. The asset will have no name if this is left empty.	Company Logo 2024

{
  "data": {
    "message": "Accepted",
    "statuscode": 202
  }
}

Update Campaign

Edit an existing campaign | key: updateCampaign

Input	Notes	Example
Data	Additional data to update the campaign
Connection	The Bynder connection to use.
Description	The description of the campaign	Official company logo for external use, approved by marketing.
Campaign ID	The ID of the campaign to update	00000000-0000-0000-0000000000000000
Key	A 4-character key representing the campaign.	CAMP
Name	The name of the campaign	Company Logo 2024
Responsible ID	The unique identifier of the user responsible for the campaign.	00000000-0000-0000-0000-000000000000

{
  "data": {
    "name": "Example campaign",
    "key": "excp",
    "description": "Campaign example",
    "dateStart": "2015-01-01T00:00:00",
    "deadline": "2015-09-04T00:00:00",
    "responsibleID": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "campaignMetaproperties": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234"
  }
}

Update Collection

Edit an existing collection | key: updateCollection

Input	Notes	Example
Connection	The Bynder connection to use.
Collection Description	The description of the collection to create	Official company logo for external use, approved by marketing.
Collection ID	The ID of the collection to update	00000000-0000-0000-0000000000000000
Is Public	When true, the collection is publicly accessible.	true
Collection Name	The name of the collection to create	Company Logo 2024

{
  "data": {
    "message": "Created",
    "statuscode": 201
  }
}

Update Job

Edit an existing job | key: updateJob

Input	Notes	Example
Accountable ID	Id of the user responsible for the job	00000000-0000-0000-0000000000000000
Data	Additional data to update the job
Campaign ID	Id of the campaign the job is part of	00000000-0000-0000-0000000000000000
Connection	The Bynder connection to use.
Description	The description of the job	Official company logo for external use, approved by marketing.
Job ID	The ID of the job to update	00000000-0000-0000-0000000000000000
Name	The name of the job	Company Logo 2024

{
  "data": {
    "status": "Created",
    "job_id": "E5F6A7B8-C9D0-1234-E5F6-A7B8C9D01234"
  }
}

Update Order

Update an existing order | key: updateOrder

Input	Notes	Example
Connection	The Bynder connection to use.
Order ID	The ID of the order to update	00000000-0000-0000-0000000000000000
Message	A message to include with the order status update.	Order has been delivered
Order Status	The current status of the order.
Tracking Number	The tracking number for the order shipment.	1Z999AA10123456784

{
  "data": {
    "message": "Created",
    "statuscode": 201
  }
}

Update User

Edit an existing user | key: updateUser

Input	Notes	Example
Data	Additional fields to include in the request body as a JSON object.
Connection	The Bynder connection to use.
Email	The email address used to identify and authenticate the user.	john.doe@example.com
First Name	The first name of the user.	John
ID	The ID of the user to update	00000000-0000-0000-0000000000000000
Last Name	The last name of the user.	Doe
Password	The password used to authenticate the user.	p@ssw0rd-example
Profile ID	The unique identifier of the security profile that determines the user's access rights. Retrieve available profiles using the List Security Profiles action.	00000000-0000-0000-0000000000000000
Username	The username for login. If not defined, the email address is used as the username.	user123

{
  "data": {
    "id": "A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890",
    "username": "jane.smith"
  }
}

Upload Chunk

Upload a chunk of a file. | key: uploadChunk

Input	Notes	Example
Chunk	The chunk index number being uploaded (indexing starts from 1).	1
Chunks	The total number of chunks the file is split into for upload.	1
File	The file or chunk of the file to be uploaded.
Multipart Parameters	The parameters for the multipart upload. Use all fields from the response of the initialise upload call.
Upload URL	The Amazon S3 upload endpoint URL received from calling the Get Closest Amazon S3 Upload Endpoint action.	https://bynder-public-eu-central-1.s3.amazonaws.com/

{
  "data": {
    "PostResponse": {
      "Location": [
        "https://bynder-public-us-east-1.s3.amazonaws.com/pluploads%2FA1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890%2Fbrand-logo.pdf"
      ],
      "Bucket": [
        "bynder-public-us-east-1"
      ],
      "Key": [
        "pluploads/A1B2C3D4-E5F6-7890-A1B2-C3D4E5F67890/brand-logo.pdf"
      ],
      "ETag": [
        "\"1c32d785398e3a7eaab0e9b876903cc6\""
      ]
    },
    "filename": "api_uploads/B2C3D4E5-F6A7-8901-B2C3-D4E5F6A78901/C3D4E5F6-A7B8-9012-C3D4-E5F6A7B89012/Logo.png/p5"
  }
}

Changelog

2026-02-18

Updated documentation and various standardizations.

Bynder is a leading digital asset management software that allows users to easily create, find, and use content, such as documents, graphics, and videos.

Description​

API Documentation​

Connections​

OAuth 2.0 Client Credentials​

Prerequisites​

Setup Steps​

Configure the Connection​

OAuth 2.0​

Prerequisites​

Setup Steps​

Configure the Connection​

Data Sources​

Select Campaign​

Select Collection​

Select Job​

Actions​

Add Asset Metaproperty Options​

Close Campaign​

Create Campaign​

Create Collection​

Create Job​

Create User​

Delete Asset​

Delete Asset Metaproperty Options​

Delete Campaign​

Delete Collection​

Delete Job​

Delete User​

Download Specific Asset Item​

Finalize Complete Upload​

Finalize Complete Upload And Save As New Asset Additional​

Generate Dynamic Asset Transformation​

Get Account Information​

Get Asset​

Get Campaign​

Get Closest S3 Upload Endpoint​

Get Collection​

Get Current User​

Get Job​

Get Job Preset​

Get Media of Job​

Get Order​

Get Order Info​

Get Security Profile​

Get User​

Initialize Upload​

List Assets​

List Brands​

List Campaigns​

List Collections​

List Jobs​

List Jobs By Campaign​

List Metaproperties​

List Orders​

List Security Profiles​

List Users​

Raw Request​

Register Uploaded Chunk​

Retrieve Poll State​

Save a New Asset​

Save as a New Asset Version​

Share Collection​

Update Asset​

Update Campaign​

Update Collection​

Update Job​

Update Order​

Update User​

Upload Chunk​

Changelog​

2026-02-18​

Description

API Documentation

Connections

OAuth 2.0 Client Credentials

Prerequisites

Setup Steps

Configure the Connection

OAuth 2.0

Prerequisites

Setup Steps

Configure the Connection

Data Sources

Select Campaign

Select Collection

Select Job

Actions

Add Asset Metaproperty Options

Close Campaign

Create Campaign

Create Collection

Create Job

Create User

Delete Asset

Delete Asset Metaproperty Options

Delete Campaign

Delete Collection

Delete Job

Delete User

Download Specific Asset Item

Finalize Complete Upload

Finalize Complete Upload And Save As New Asset Additional

Generate Dynamic Asset Transformation

Get Account Information

Get Asset

Get Campaign

Get Closest S3 Upload Endpoint

Get Collection

Get Current User

Get Job

Get Job Preset

Get Media of Job

Get Order

Get Order Info

Get Security Profile

Get User

Initialize Upload

List Assets

List Brands

List Campaigns

List Collections

List Jobs

List Jobs By Campaign

List Metaproperties

List Orders

List Security Profiles

List Users

Raw Request

Register Uploaded Chunk

Retrieve Poll State

Save a New Asset

Save as a New Asset Version

Share Collection

Update Asset

Update Campaign

Update Collection

Update Job

Update Order

Update User

Upload Chunk

Changelog

2026-02-18