☝️ To get started, you’ll need to add the free API plugin to your portal. You can request this from our support team via chat or by emailing [email protected].
💡 The Douano API uses the OAuth2 Authorization flow to grant access to the API. You can find more details via this 👉 link.
Generate a Client ID and Secret
To start with an OAuth2 Authorization flow, you need to create an API user.
⇢ Go to Settings > Public API > API Integrations, where you can create a new integration using the green plus button ![]()
Name: Choose a name of your choice for this integration.
Redirect URL: You can retrieve this from the external software that needs to be connected to the Douano API. This URL is required to send the authorization code to.
Revoked: If you wish to stop the data exchange with the external software, you can check this option.
💡 When you click "Save" and reopen this integration afterwards, it will display a Client ID and Secret.
Use the Client ID and Secret in an external application
Step 1: Request access (Authorization Flow)
To use the API, first request permission from your external application using the OAuth2 authorization flow.
Authorization URL:
https://<your-douano-url>/authorizeGrant Type: Use Authorization code
Step 2: Request Access Token & Refresh Token
Once access is approved, request an access token via the token URL:
Token URL:
https://<your-douano-url>/oauth/token
Upon a successful request, you will receive two keys from Douano:
🔑 API Access Token (valid for 1 day): Used to execute the actual API requests.
🔄 API Refresh Token (valid for 1 year): Allows your application to automatically request a new Access Token daily, eliminating the need to manually go through the authorization flow every day.
Postman – Douano Public API Documentation
💡 All features of the Douano API are documented in Postman.
Click this 👉 link to open Postman.