Configuring Mattermaps APIs

Written by Binod Paul

Mattermaps Premium & Enterprise Packages allow companies to use APIs to connect Mattermaps to external data sources, such as ERP and PLM systems.

What are some benefits of using our APIs?

Standardization: APIs provide a standardized way to securely access and retrieve data from external systems, allowing Mattermaps to incorporate and utilize Company's existing data. This way your company can scale the exchange of PCFs and focus on what's important.

Extensibility and Customization: By exposing certain functionalities or data through APIs, Mattermaps allow customers to integrate the SaaS application with their own internal systems or third-party tools, tailoring the solution to their specific needs.

Scalability and Flexibility: Using APIs to fetch data from external sources, rather than uploading all data within Mattermaps application, can improve scalability. For example, if companies already have an established calculator tool and are interested only in acquiring primary data via Mattermaps.

Improved User Experience: By integrating data from various sources through APIs, Mattermaps provides a more comprehensive and valuable user experience. Users can access and work with data from multiple systems within Mattermaps, without having to switch between different tools or platforms, or upload data manually via excel files.

Troubleshooting

Create Your First Technical User

 

Other Information About Us

 

I Lost My Credentials, How To Retrieve Them?

 

How To Delete a Technical User?

 

Available APIs

 

I Want To Connect My Plant To Mattermaps

 
 

Once you have Mattermaps Premium or Enterprise Package, you can start creating your first Technical User (TU). A technical user, in our context, is a non-human user account or identity that is used to facilitate the communication and data exchange between Mattermaps and your existing systems and databases. This technical user account has the necessary permissions, credentials, and access rights to interact with the APIs, resources, or services of both systems.

Creating your first TU is super easy.

 

  1. Navigate to Configure > API Management section
  2. Click on Create Technical User

Technical User Rights

To better manage your Technical Users in the future, add all specific information when creating them. This will help future users to know how the TU is being used in your Company.

  1. Add the TU name and description
  2. Select specific API scopes
  • If your company has a Mattermaps Premium subscription, then you will only have access to Basic APIs.
  • If you company has a Mattermaps Enterprise subscription, on top of Basic APIs you may also have a Remote & Shop floor APIs, depending on your contract.

Please keep in mind that you won't be able to edit API Scopes in the future. If you would like to change the configuration please create a new Technical User.

Safely Copy & Store Your User Credentials

A new technical user will be created for you. This set of Client ID and Client Secret is your gateway to the Mattermaps API endpoints.

  1. Copy your Technical User information, Client ID and Client Secret and safely store it
  2. Update any applications connected to Mattermaps with the new credentials
 

As you may have notice your Technical User (TU) will expire after 365 days. This duration allows for regular review and renewal of technical user accounts, ensuring the ongoing security and integrity of the system.

But also, you will find that your technical user can be in different statuses:

Status Meaning Related Actions
Active Your TU is ready to use the connection with Mattermaps can be stablished You can now create your code and start sharing data between Mattermaps and your applications or databases
Suspended You, your team or Mattermaps System Admin has revoked the access for this TU. Usually a TU is set to be suspended if there is a suspected or confirmed data security breach

You can grant access to this TU from your API Management View at any time.

This action will prompt a new ClientID and ClientSecret that must be updated in any application using this TU
Expired This TU is older than 365 day

You can simple click the three dots, and select Renew.

This action will prompt a new ClientID and ClientSecret that must be updated in any application using this TU

Renewing Access to a Technical User

Renew your technical user and update your API access credentials in every application that is using Mattermaps APIs.

  1. Navigate to Configure > API Management section.
  2. Search for the Technical User (TU) for which you lost the credentials.
  3. Click on the three buttons menu on the right.
  4. Click renew.
  5. Copy the new ClientID and ClientSecret and update your applications.
  6. Remember to safely store this information as you will nee to renew it again if lost.

Deleting a technical user is very easy

 

  1. Navigate to Configure > API Management section.
  2. Look up the Technical user you would like to delete.
  3. Click on the three dots (kebab) menu.
  4. Choose Delete.

Currently Mattermaps offers to sets of different APIs:

 

  1. Basic APIs available in our Mattermaps Premium & Enterprise Packages. These APIs enable companies to integrate and exchange data with third party systems and databases. These APIs are widely use to upload supplier and component data to Mattermaps and to update PCF data from suppliers into calculation tools.
  2. Common integrations for basic APIs: Enterprise resource planning (ERP), Product-Lifecycle-Management (PLM), Energy Management System (EMS) applications.
  3. Remote APIs available in our Mattermaps Enterprise Package. These sets of APIs enable companies to operate Mattermaps in the background, without requiring of the Mattermaps user interface (UI). Also called headless APIs, they enable Companies to operate Mattermaps by using other existing applications.
  4. Common integrations for basic APIs: ERP system where the integrator between the ERP system and Mattermaps may create an extra button on your ERP to directly request PCFs, without you ever login into Mattermaps.
  5. Shoopfloor APIs available in our Mattermaps Enterprise Package. These sets of APIs enable companies to automatically create own emissions in Mattermaps directly from your plant. You may already have this functionality with your EMS system or other tools, and we want to make sure you use the data you already have and start increasing your primary share.

Accessing Mattermaps APIs

Basic APIs are part of our Mattermaps Premium package, and can be purchased from our website, or by contacting one of our representatives, also possible in our website. Note, that only Company Admins of a Mattermaps account will be able to make the purchase.

Remote and Shop floor APIs can be purchased as part of our Mattermaps Enterprise package.

Once part of Mattermaps Premium or Enterprise, companies are able to connect to set up their own data flows between Mattermaps and other tools using our APIs, and connect to their shop floor own emissions data. After the subscription is upgraded, a new section called API Management, under Configure will be accessible and Company Admins will be able to create their own Technical Users. Mattermaps Technical User Management provides a robust framework for managing access to your APIs. Enjoy a seamless experience while maintaining security and control!

 

Mattermaps Connect

A powerful industrial integration solution to automatically calculate & transfer own emissions from your production facility to Mattermaps.

You can request this feature in the Configure Settings, under "Add Ons".

Our Mattermaps Connect offering:​

  • Use factory emission data for more accurate PCFs​
  • Automated calculation of own emissions for all your products​
  • Implementation of customized calculation logic​
  • Secure Connectivity between IT/OT and Mattermaps​
  • Dashboard for analytics and settings​

Our Approach

Unlock the power of automation with our expert team of consultants, software architects, and developers. Together, we guide you through three strategic steps to achieve seamless, gate-to-gate emissions calculation—tailored to your operations and ready for the future.

  1. Business Understanding
  2. Mattermaps Gate-2-Gate Workshop
  3. Implementation project 
    (integrate to IT and set-up cloud infrastructure and calculation)
 
 

Our Success Stories

Discover how leading companies overcame the challenge of gate-to-gate emissions calculation—real stories, real impact, real results.

 
 

Frontend to Manage Your Connect Set Up

The world evolves—so does your product portfolio. Whether you're installing solar panels or upgrading your energy metering, Mattermaps Connect adapts with you. Use our intuitive frontend to effortlessly manage your setup and stay ahead.

Curious about what drives your product’s PCF—and how to influence it? Our interactive dashboard with powerful visualizations helps you uncover key levers and make data-driven decisions with confidence.

Discover our features:

  • Manage metering
  • Manage non-metered consumptions
  • View change history
  • Manage emission factors
  • Manage allocation method
  • Analyze input and output data in diagrams
 
 

Start with a Pilot

Seamless Start, Scalable Integration

We understand that integrating new solutions into your IT landscape can be a big step. That’s why we make it easy to start small: test the waters with your own data and quickly build a compelling showcase—without the need for full integration upfront.

Upload your data via Excel or CSV and benefit from our precise calculation and allocation methods, fully connected to your Mattermaps account.

And when you're ready to scale up? No problem. We support a smooth upgrade to full IT integration—without any double work or data loss.

 
 
 
 
 

On this page

Renewing Access to a Technical User Accessing SiGREEN APIs

Related Articles