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
Dankuwel!