Connect your AI providers
Connect each AI tool or model API your company pays for, so its spend shows in Flowstate, against the people who used it where the provider reports that. Start here, then follow the guide for each provider.
What you can connect
“Invoiced” cost is the provider’s own figure. “Estimated” cost is worked out from usage, as the provider’s guide explains.
| Name in Settings | You connect with | What it gives you | Guide |
|---|---|---|---|
| Anthropic API (Console) | An Admin key | Invoiced cost and token usage, per person | Claude |
| Claude Enterprise | An Analytics API key | Invoiced cost and token usage, per person | Claude |
| OpenAI Platform API | An organisation admin key | Invoiced cost per project, and token usage per person | OpenAI Platform API |
| GitHub Copilot (Business / Enterprise) | A personal access token and your GitHub organisation | Invoiced cost, and activity per person | GitHub Copilot |
| Microsoft 365 Copilot | An app registered in Microsoft Entra | Licensed people and their Copilot activity, per person; no cost | Microsoft 365 Copilot |
| Cursor (Pro / Business / Enterprise) | A Cursor Admin API key | Invoiced cost, per person | Cursor |
| Windsurf (Pro / Enterprise) | A team service key | Estimated cost and activity, per person, for the current billing cycle | Windsurf |
| Gemini API (AI Studio) | Access to your Google Cloud billing export | Invoiced cost by product, total only | Gemini API and Vertex AI |
| Vertex AI (GCP) | Access to your Google Cloud billing export | Invoiced cost by product, total only | Gemini API and Vertex AI |
| Azure OpenAI Service | Access you grant in Microsoft Entra | Invoiced cost, total only | Azure OpenAI Service |
| Amazon Bedrock | An AWS IAM role | Invoiced cost, total only | Amazon Bedrock |
| Mistral (Enterprise) | An Admin API key | Invoiced cost by month and category, total only | Mistral |
| Fireworks AI | An API key and account ID | Invoiced cost, total only | Fireworks AI |
| ElevenLabs | A service account key | Invoiced cost for the current subscription period, total only | ElevenLabs |
| Intercom Fin | An access token and your cost per resolution | Estimated cost, total only | Intercom Fin |
Every connection syncs every hour.
Six of these also connect from Organisation → Organisation → Integrations: Claude Platform (Anthropic API (Console) in the table), Claude Enterprise, OpenAI Platform (OpenAI Platform API), GitHub Copilot, Cursor and Windsurf. They also connect from Settings → Connections in Flowstate Helm. The other providers connect from Settings → Integrations.
Two other ways to see AI use:
- Prompts and responses. Anthropic Compliance API, OpenAI Logs API, and content logs for Amazon Bedrock and Vertex AI bring in what people send to AI, not spend. See Capture AI prompts and responses.
- Which projects AI was used for. Flowstate Desktop records AI use on your company computers. See Roll out Flowstate Desktop and Track AI in your workflows.
Before you start
- You need access to connect AI providers. Ask your Flowstate admin.
- Load your people and teams first, with work email addresses. Flowstate matches each provider’s users to your people by email.
- The spend screens under Insights → Agent insights appear once your Flowstate contact has switched on AI spend.
1. List the AI tools you pay for
What: Agree which provider accounts to connect, and who has admin access to each one. Who: Finance lead, with IT. Where: Your AI invoices, and What each connection brings. Done when: You have a list of providers, with a named admin for each.
2. Create a read-only key at each provider
What: Create the key, token or access Flowstate reads billing with. A read-only key is enough for spend and people. A key that can manage members is needed only to give or remove tools from Users & teams; the connect form in Flowstate says which key. Who: The admin for that provider. Where: The provider’s own console. Each provider’s guide has the steps. Done when: You have the key ready to paste into Flowstate.
3. Connect each provider in Flowstate
What: Add each key to Flowstate. Who: Flowstate admin, with the provider admin. Where: Organisation → Organisation → Integrations, or Settings → Integrations if your organisation doesn’t use Organisation yet or the provider isn’t one of the six above. Done when: The provider’s key shows Working under Connected keys.
- Go to Organisation → Organisation → Integrations and select the provider, under AI providers or AI coding tools.
- Select Connect, or Add another account if the provider already has one connected.
- Enter the key and select Verify and connect.
If your organisation doesn’t use Organisation yet, or the provider isn’t one of the six above, go to Settings → Integrations and select Browse catalog. Under Filter by capability, choose AI spend, and open the provider. Under How to connect, select Use this route. Then enter the key and select Verify and connect.
Your past spend starts coming in straight away. Until the first sync has run, the key’s status reads Waiting for first sync. On each connected key you can Sync now, Replace key, Rename connection or Disconnect.
4. Check spend is matched to people
What: Make sure spend lands against the right people. Who: Flowstate admin. Where: Insights → Agent insights. Done when: Spend from each provider appears, and providers that report per person show your people’s names.
- Flowstate matches a provider’s users to your employees and contractors by email address.
- Anyone who doesn’t match is matched once you add them to Flowstate or correct their email.
- Providers that only report a total have nobody to match. See What you can connect.
What each connection brings
The table in What you can connect shows which providers report per person and which only send a total. Each provider’s guide has the rest, including how much history comes in. For how AI spend shows across Flowstate, see AI usage providers.
You’re set up when
- Every provider on your list has a key showing Working under Connected keys.
- Spend from each one appears under Insights → Agent insights.
- Providers that report per person show your people, not unmatched users.
If something’s not right
Connect is greyed out, with “Ask an admin for Manage AI Telemetry Keys” beside it. Your role doesn’t include Manage AI Telemetry Keys. Ask your Flowstate admin to connect the provider for you, or to add it to your role. See Roles and permissions.
“You do not have permission to connect provider keys. Ask an administrator.” Ask your Flowstate admin to connect the provider for you.
“That key was refused. Check you copied the whole thing, and that it is the key type this route asks for.” The provider looked at the key and said no. Select Show what the provider said to see its reason, then check you copied the whole key and that it’s the type the provider’s guide asks for. What you pasted stays in the box, so you can correct it.
“We could not verify that key. Nothing has been saved, so you can correct it and try again.” Flowstate didn’t get a clear answer about the key from the provider, for example because the provider was busy or unavailable. Wait a few minutes and try again. If Show what the provider said is there, it may say why. If it keeps happening, contact Flowstate support.
Spend shows, but not against people. The provider only reports totals, or its users’ email addresses don’t match anyone in Flowstate. Add or correct those people.
For your technical team
Amazon Bedrock, Azure OpenAI, and Google Cloud for Gemini and Vertex AI connect through access you grant in your cloud account, not a pasted key. No long-lived secret leaves your cloud account. Each provider’s guide has the set-up.