Docs · Finance

Connect Polar

Docs · Updated

Your net revenue from Polar orders - what is paid out to you, after Polar's and the card processor's fees - for today, the week and the last 30 days, with a 14-day line.

Tiles: Polar, Polar Chart - in the widget picker under Finance.

Before you start

  • A Polar organization. Sandbox organizations work too.

Steps

  1. In the Polar dashboard open Settings, scroll to Developers and click New Token.
  2. Give it a name and an expiry date, and pick the scopes metrics:read and orders:read.
  3. Create it and copy the token. It starts with polar_oat_.
  4. In lumabar, right-click the dock, choose Widgets…, open Finance and click Polar or Polar Chart to add it.
  5. Click the new tile on the dock. Its card opens.
  6. Fill in the card as shown below and press Connect. lumabar checks it with one real read - if anything is wrong, the card says what.

What to enter

Field on the cardWhat goes in it
API keyThe organization access token, polar_oat_…

Good to know

  • orders:read lets the tile show your own currency. Without it the numbers are still right, but shown in USD.
  • A sandbox token is recognized on its own - the card then says Test mode.
  • When the token expires, make a new one and connect again.

If it doesn't connect

The card says what went wrong, in words like these:

“Polar rejected that key”

The token was not copied whole, or it expired. Create a new one.

“Polar accepted the key but it is not allowed to read this”

The token is missing a scope. Create one with metrics:read and orders:read.

Still stuck? Send feedback or write to us - we answer every message.

Privacy

The key is stored only on this PC, is sent only to Polar, and is used only to read. To remove it, click the tile and press Disconnect, or right-click the tile and choose Logout.

Sources

Connect another account