/
Menu

Connections Solo plan

Connect Stripe, AWS or Polar so StackHangar reads daily revenue or spend and shows it on each project. Needs the Solo plan.

A connection lets StackHangar read numbers from a provider once a day, so each project shows what it earns or costs without you opening billing pages. Connections only read. They never change anything at the provider.

Connections are in early access, and they are part of the Solo plan. See Plans.

#What is available

You can connect these providers today:

ProviderWhat StackHangar readsThe token you create
StripeDaily revenue, refunds and feesA restricted API key with Balance set to Read
AWSDaily cost by tag or linked accountAn IAM user access key allowed only to read cost data
PolarDaily revenue for your organizationAn organization access token that can only read metrics

Paddle, Vercel and OpenRouter are not available yet, and you won't see them in the list. Other providers aren't offered, because they don't let you create a token that can only read.

How to create each token is on Provider tokens.

#How it works

For these providers, StackHangar's server keeps the read-only token, encrypted, and calls the provider once a day. The screen calls this a Server connection.

The server stores only the connection, its provider, dates and amounts. It never sees your vault or any other secret, and it never learns which project or account a connection belongs to. That link is saved inside your encrypted vault. See What StackHangar can see.

Amounts are kept per currency and are never converted or added across currencies.

#Add a connection

Before you start:

  • You need the Solo plan. On Free you can open the page and fill in the form, but adding a connection is refused with a message that connections are part of Solo.
  • Unlock your vault, and have a passkey ready. See Unlock your vault.
  • Create the token at the provider. See Provider tokens.

Steps:

  1. Open Connections in the sidebar.
  2. In Add a connection, choose a Provider. The numbered steps for creating its token appear.
  3. Paste the token into the field. It is treated as a secret and cleared from the page as soon as you submit.
  4. Optionally, under Link to a provider account (optional), choose one of your accounts for that provider, so projects using that account show its numbers.
  5. Choose Approve with passkey and add, and complete the passkey check.

StackHangar then reads from the provider straight away. The result appears at the top of the page, such as "The first read worked", or the reason the first read failed.

You can have up to 50 connections.

#If a token is refused

StackHangar refuses a token that can do more than read, or that is the wrong kind, and doesn't store it. The message says which. Create a token again with exactly the permissions in the steps, then add it again.

#See the numbers

  • Each connection is a card on Connections with its provider, Server connection and status badges, and when it was Last synced.
  • On a project page, Spend and revenue from connections shows the month to date (UTC) for the connections linked to that project's accounts. If an account is shared with other projects, the page says its totals include the other projects.

If you didn't link it when you added it, open Connections and find Link connections to provider accounts. For each account, choose a connection under Connection and Save link. Unlink removes the link.

You can also link from an account page. See Accounts.

#Set a budget

Cards for providers that report spend have Monthly budget, with a currency. Choose Set budget to save it, or Clear. StackHangar emails you when spend this month passes the budget. Stripe and Polar report revenue, so they have no budget.

#Alerts

Deterministic rules check the numbers and email you counts only, never a project, provider or account name:

  • Spend rose sharply: the average daily spend over the last 7 days is more than 1.5 times the average of the 28 days before.
  • Budget passed: spend this month is over the budget you set.
  • A connection needs a new token.

See Alerts.

#Statuses

StatusMeaningWhat to do
SyncingNumbers update automatically. A last failure such as Couldn't reach the provider may show, and StackHangar tries again.Nothing
Needs a new tokenThe provider refused the token three times in a row.Remove the connection, create a new token and add it again
Token refusedThe token was too broad or the wrong kind, so syncing stopped and any copy StackHangar held was deleted.Create a read-only token and add it again
PausedNothing is fetched, because your plan doesn't include connections or StackHangar doesn't offer the provider yet.Syncing resumes when both allow it

Other failure messages on a card:

  • Token not accepted: the provider rejected the token. Check it hasn't expired or been revoked.
  • Token lacks permission: create a new token with exactly the permissions in the steps.
  • Account not found: check the connection, or remove it and add it again.
  • Provider is limiting requests and Provider error: StackHangar waits and tries again later.
  • Unexpected response: the provider sent data StackHangar doesn't read, and nothing from it was saved.

#Rotate a connection's token

A connection's token can't be replaced in place. To rotate it:

  1. Create a new token at the provider, using the same steps.
  2. On Connections, remove the connection, then add it again with the new token. See below.
  3. Re-link it to the account if it isn't linked already.
  4. Revoke the old token at the provider.

Removing a connection deletes its stored numbers.

#Remove a connection

On the connection's card, choose Remove, then Yes, remove. The server's copy of the token and the stored numbers are deleted, and the removal is recorded in your activity log. You can add it again later.

Removing a connection doesn't revoke the token at the provider. Revoke it there too if you no longer need it.

In this section