Create an API Key
      Back to home
      1. Help Center
      2. Integrations
      3. Create an API Key

      How Do I Create an API Key?

      A guide on how to easily create API keys that can be used for all integrations.

      An API (Application Programming Interface) is an interface that allows integration with a third party system e.g. Power BI. You can use the API to build custom integrations or automate even more of your workflow.

      To use the API you must create an API key. An API key is a personal code and acts as an authentication token or a unique identifier. To find out more about how and for what you can use the API key go to Impero API Documentation

      Note: To create an API key you must either have the Administrator or API User role. You want to know more about roles in Impero? Go to Manage Users, Roles and User Groups

      NB! The API key has access to the same data as the creator of the key. I.e. if the creator has Administrator access, so does the key.

      1. Log into Impero i.e. https://your_organization.impero.com
      2. Click "My Profile"
      3. In the bottom of the page, you will find your API keys.
      4. Click "Create API key", as illustrated below:
      5. Provide a name for the key that describes its purpose. The name is for identification purposes only.
      6. Provide an expiry date for the key or leave it at never expires
        1. Controls: which allows updating and dispatching existing controls.
        2. View control activities: which allows viewing of the control activities and answers to controls
        3. Datasheet: which allows accessing and modifying datasheet content. NB here you can choose either Update datasheet content which allows updating of datasheet content or View datasheet structure which only allows viewing of datasheet structure Select the scope for the API key. The scope determine what operations you can perform on the data. You can select:
        4. View risks: which allows viewing risk directories and assessments
      8. Click "OK"
      9. A new API key will now be visible on the screen. Copy and save the API key as you will not be able to access the key again after closing the dialog box. The API key will be used in the Starter template.

      Tip: We recommend a key for each integration and for different purposes. Each user can create multiple API keys.


      Learn more: 

      Do you want to know how to connect Impero to PowerBI? Go to How do I connect Impero to PowerBI?