Set up a connection to Basware

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your Basware account API type:

API type: Basware 

API version * 

Select your Basware account API version (v1 or v2). 

Environment * 

Select your Basware account environment:

Region * 

Select your Basware account region (Australia, Canada, Europe, or USA).

Auth type * 

Select your Basware account authentication type (Basic or OAuth 2.0).

Auth type: Basic 

Username * 

Enter your Basware account username.

Password * 

Enter your Basware account password.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.

Auth type: OAuth 2.0 

OAuth 2.0 client * 

Select the OAuth 2.0 client that stores the client ID and client secret provided by Basware.

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit () button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource.

Scope *

Scopes are OAuth 2.0 permissions that Basware defines to limit access to your account.

​​ How to configure scopes

API type: Vault 

Environment * 

Select your Basware account environment: 

Region *

Select your Basware account region (Europe).

Vault ID *

Enter your Basware account vault ID required for the Ping URL https://api.basware.com/v1/vaults/{{{settings.connection.vaultId}}}/documents/status.

Username *

Enter your Basware account username.

Password *

Enter your Basware account password.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.

API type: Data access

Environment *

Select your Basware account environment: 

Region *

Select your Basware account region (Australia, Europe, or USA).

Auth type *

Select your Basware account authentication type (Basic or OAuth 2.0).

Auth type: Basic

Username *

Enter your Basware account username.

Password *

Enter your Basware account password.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.

Auth type: OAuth 2.0

OAuth 2.0 client *

Select the OAuth 2.0 client that stores the client ID and client secret provided by Basware.

To add an OAuth 2.0 client and configure your credentials, click the plus (+) button. Click the edit () button to modify a selected OAuth 2.0 client. For more information, see Create an OAuth 2.0 iClient resource.

Scope *

Scopes are OAuth 2.0 permissions that Basware defines to limit access to your account.

​​ How to configure scopes

API type: SmartPDF

Environment *

Select your Basware account environment: 

Region *

Select your Basware account region (Europe).

API access key *

Enter your Basware account API access key.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s access key safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.

API type: Network

API version *

Select your Basware account API version (v1, v1.1, v2, or v3).

Vendor ID * (for V1 API version)

Enter your Basware account vendor ID for the Ping URL https://api.basware.com/v1/vendorDetails/{{{settings.connection.vendorId}}}.

BUM ID * (for V3 API version)

Enter your Basware account BUM ID for the Ping URL https://api.basware.com/v3/invoices/{{{settings.connection.bumId}}}.

Username *

Enter your Basware account username.

Password *

Enter your Basware account password.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s password safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.