Introduction

The primary method for accessing UltiMaker services is by using OAuth2. This is suitable when a web application needs to access the resources in UltiMaker services on behalf of current user. OAuth2 makes it possible for a user with an account at UltiMaker to delegate access to another application outside UltiMaker. This makes it possible for an application to perform actions on UltiMaker services on behalf of the user.

UltiMaker Digital Factory also supports the creation and use of API Tokens. These need to be manually created inside Digital Factory and are suitable for situations where a non-interactive server application or script needs to perform actions in Digital Factory on behalf of one user. This page has more details about API Tokens

What is OAuth2?

To use one or more Ultimaker services, you'll need to authenticate your application. For this we follow the OpenAuth 2.0 (OAuth2) standard. You might recognize this standard from other popular API based services like Google, GitHub and Twitter. More specifically, we support the Authorization code grant type, which allows the user to securely login on our servers before being redirected back to your application.

Request client credentials

In order to implement OAuth2 you'll need to request client credentials from Ultimaker. You can do this by sending an email to support@ultimaker.com. If the request is accepted, you'll receive a client ID and secret which are needed to perform the OAuth2 flow.

Warning

Not everyone is automatically eligible for receiving Cloud API credentials. Please check our support website to see if you are eligible for receiving Cloud API credentials.

Implementing the OAuth2 flow

Follow our detailed OAuth2 flow guide to connect your application.

Scopes

The list of available scopes is available here.