Toggle menu

Setting up Contribute

iCM user and API key

The Contribute product creates articles and media items in iCM. To do this it needs an iCM user to act as, via an API key. The user should be given a meaningful name like CONTRIBUTEEVENT. Create an iCM user and note down the username and password.

Contribute iCM users need sufficient iCM Privileges to be able to create content in iCM, but these should be kept to a minimum. Users should generally be given full article and media privileges, and content roots that only include the template type and parent article IDs of the content they will be creating or updating. They should only have access to the media group you created earlier.

API keys

Rather than adding usernames and passwords into your configuration, Contribute uses an API key to act as the iCM user created above.

Create a key with a meaningful name and add the icmapi worker to it. We recommend create a separate key (and iCM user) for each instance of Contribute you set up:

API Keys

The key needs to supply the username and password of your Contribute iCM user, you can leave the authentication type as "None":

Supplying Worker Credentials

Make a note of your API key.

Last modified on 16 March 2026