All Collections
Troubleshooting & Use cases
Use cases
How to work with Bright River using our External Post API
How to work with Bright River using our External Post API
Viviana avatar
Written by Viviana
Updated over a week ago

If you are working with Bright River as an External Vendor you can now build a API connection by using Creative Force's own External Post API Gateway.

This article will guide you through the setup on Creative Force.

1) Setting up a new Vendor

To start with you, want to add the Bright River Vendor to your External Post Production list and select the “Gateway API” as the connection type:

As a next step, you will be asked to add the Webhook URL which Bright River will be able to provide you. This will effectively be the URL that images are delivered to. After filling this out and clicking “Save”, Creative Force will automatically generate the secret key that needs to be shared with Bright River for the further setup on their end:

2) Register a new app

As soon as you’ve completed the Vendor setup and saved your changes, you can proceed to the next step of registering an App. This will allow Bright River to make the necessary API calls to Creative Force to complete the post-production process.

To do this, hover over the Integrations menu and Register a new app:

Bright River works with the Client Authentication flow as “Grant type”. You will want to select “Client credentials” and name the application accordingly.

Please note that the user you assign here needs to have a certain level of permissions, further information about that and the setup can be found here.

After clicking on “Save” we will generate an Application ID and a Secret key, both need to be shared with Bright River for them to access the app:

Once you created the new Vendor and the app you can move forward with updating the Vendor on your Workflow and adding the specification mapping.

3) Share client ID with Bright River

Before diving into the specification settings there is one last piece of information to grab from Creative Force that is needed by Bright River- the client ID.

To get the client ID, which varies for each client you've created, navigate to your client settings. Clicking "Edit" will display the client ID you can share with Bright River.

4) Setting up the Bright River specification ID

Now you would want to go back to your Vendor settings and complete the “Specification settings”.

Bright River will need to share with you their internal specification ID and template names, which you can then use for the further setup on your Style Guide. These specification information are sent to Bright River when downloading the task helping them to allocate the right template for the retouching steps.

If a template is no longer needed you can remove it from here:

5) Add the Vendor to your Workflow

The second last step is to assign this newly created Vendor to your existing workflow(s):

6) Map Bright River’s specifications templates to your Style Guide

Lastly, you would want to go over to your Style Guide and from there, by clicking on the “External Post” tab on the left side, you will be able to assign the templates previously set up (Step 3 of this article)

Did this answer your question?