OAuth endpoints

Here we describe the endpoints needed when you want to build an integration with Robaws using the OAuth 2 standard.

Preconditions:

You need to register your integration (at the moment only possible via e-mail: support@robaws.com) in order to obtain a client id & secret.
Please document the needed scopes.
Also provide us with a redirect URL.

The available scopes are:

• settings
• clients
• work-orders
• planning-items
• employees
• materials
• installations
• profile
• projects
• articles
• posts
• sales-orders
• stock-changes
• offers
• users

Authorize endpoint

Request method: GET
URL: https://app.robaws.com/oauth2/authorize

Required query parameters:

client_id
redirect_uri

Optional query parameters:
state
response_type (default = code)
scope
state

Tokens endpoint (authorization code flow)

For exchanging an authorization code for access & refresh token.

Request method: POST
URL: https://app.robaws.com/oauth2/tokens
Content-Type: application/x-www-form-urlencoded

Required body parameters:

grant_type (authorization_code)
client_id
client_secret
code
redirect_uri

Tokens endpoint (refresh)

For exchanging a refresh token for a new access & refresh token.

Request method: POST
URL: https://app.robaws.com/oauth2/tokens
Content-Type: application/x-www-form-urlencoded

Required body parameters:

grant_type (refresh_token)
client_id
client_secret
refresh_token

Bijgewerkt op: 24/11/2025