Brandfolder Events

Cloud Elements currently supports events via polling or webhooks depending on the endpoint.

Polling is a mechanism where Cloud Elements executes the configured query every n minutes and captures the changed information.

Webhooks are when the provider lets Cloud Elements know what information has changed. Note that additional endpoint setup may be required prior to creating your element instance.

Note: Cloud Elements normalizes only the objectId, objectType, and eventType event data. Event data also contains raw data, which the provider returns. The raw data varies based on the endpoint.

If you would like to see more information on our Events framework, please see Events Overview.

Brandfolder requires an extra specification to be entered once an element instance has been created. The Brandfolder Instance ID must be 64 base encoded, then included in the webhook callback URL. This document will walk you through the entire workflow:

create an instance

retrieve the instance ID

64base Encode Instance ID

webhook setup

Step 1. Call the /instances API

HTTP Headers: Authorization- User , Organization

HTTP Verb: POST

Request URL: /instances

Request Body: Required – see below

Query Parameters: none

Description: token is returned upon successful execution of this API. This token needs to be retained by the application for all subsequent requests involving this element instance.

This instance.json file must be included with your instance request. Please fill your information to provision. The “key” into Cloud Elements Brandfolder is "brandfolder". This will need to be entered in the “key” field below depending on which element you wish to instantiate.

If the user does not specify a required config entry, an error will result notifying her of which entries she is missing.

Below is a successful JSON response:

{"id":1234,"name":"Test","token":"cuED0/DezalhhzK2OtO6kMP7NvPnMyNcRDZc=","element":{"id":489,"name":"Brandfolder","hookName":"Brandfolder","key":"brandfolder","description":"Add an Brandfolder Instance to connect your existing Brandfolder account to the General Hub, allowing you to manage assets and attachments across multiple elements. You will need your Brandfolder account information to add an instance.","image":"https://assets.brandfolder.com/6xnhmr5n/original/brandfolder_logo_black.png","active":true,"deleted":false,"typeOauth":false,"trialAccount":false,"resources":[]},"provisionInteractions":[],"valid":true,"disabled":false,"maxCacheSize":0,"cacheTimeToLive":0,"configuration":{"base.url":"https://api.brandfolder.com/v2","event.notification.subscription.id":null,"event.notification.instance.finder":"","pagination.type":"cursor","event.poller.refresh_interval":"15","event.notification.callback.url":null,"api-token":"BRANDFOLDER_USER_TOKEN","pagination.max":"50","event.vendor.type":"webhooks","authentication.time":"","event.poller.configuration":"{\"brandfolders\":{\"url\":\"/hubs/general/brandfolders?where=updated_dt>'${date:yyyy-MM-dd'T'HH:mm:ssXXX}'\",\"idField\":\"id\"},\"organizations\":{\"url\":\"/hubs/general/organizations?where=updated_dt>'${date:yyyy-MM-dd'T'HH:mm:ssXXX}'\",\"idField\":\"id\"}}","event.notification.enabled":"false"},"eventsEnabled":false,"traceLoggingEnabled":false,"externalAuthentication":"none","cachingEnabled":false}

Note: Make sure you have straight quotes in your JSON files and cURL commands. Please use plain text formatting in your code. Make sure you do not have spaces after the in the cURL command.