Basware SmartPDF API v2

#SmartPDF

Release: 26.07

We're pleased to announce that version 2 of the Basware SmartPDF API is now available.

What's new

The invoiceUpload endpoint has moved to v2:

POST https://api.basware.com/v2/smartpdf/invoiceUpload

The request payload remains the same:

json

{"receivingEmailAddress": "receiver@abc.com", 
  "notificationEmailAddress": "sender@abc.com" }

v2 supports two authentication methods, so you can choose the one that best fits your integration:

  • Basic authentication — use an username and password with the request.
  • OAuth2 authentication — obtain a JWT token from our authentication endpoint using credentials provided by your Basware consultant, then include the token in your request. When requesting the token, include the importDocuments.write permission scope.

Full documentation is available here.

A note on v1

If your integration currently uses v1 with API key authentication, please note that API keys are no longer supported. We recommend migrating to v2 with Basic or OAuth2 authentication at your earliest convenience. Reach out to your Basware consultant if you need credentials issued.

Need help?

If you have any questions about v2 or migrating your integration, please contact your Basware support representative or open a support ticket.

Thank you for using Basware SmartPDF.