Skip to main content

Douano API

☝️ 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>/authorize

  • Grant 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.

Did this answer your question?