Connect Windsurf
Connect Windsurf to see who uses it, who doesn’t, and an estimate of what it costs per person.
You need access to connect AI providers. Ask your Flowstate admin.
Before you start
- Admin access to your Windsurf team, to create a service key and switch on individual-level analytics.
Connect Windsurf
- In Windsurf settings, open Service Key Configuration and add a service key.
- Give the key Teams Read-only permission.
- Switch on individual-level analytics at windsurf.com/team/manage. Without it, Windsurf doesn’t report people separately.
- In Flowstate, go to Organisation → Organisation → Integrations and select Windsurf under AI coding tools.
- Select Connect, or Add another account if one is already connected.
- Paste the key and select Verify and connect.
If your organisation doesn’t use Organisation yet, replace steps 4 and 5: go to Settings → Integrations, select Browse catalog and open Windsurf (Pro / Enterprise), then under How to connect select Use this route.
Check it’s working
The key is listed under Connected keys with the status Working. See usage and cost in Agent insights.
What Flowstate brings in
- Each person’s active days, and when they last used autocomplete, chat and commands.
- Each person’s prompt credits for the current billing cycle.
- Cost is estimated from Windsurf’s list prices, so it won’t reflect any discount you’ve negotiated.
- Flowstate syncs every hour.
People
If your organisation has Flowstate Helm, Flowstate also brings in the people on your Windsurf team, but not people who have asked to join and haven’t been let in, or whose access is switched off. They’re listed on Users & teams. Nobody is emailed until you invite them.
If something’s not right
No one is listed separately. Individual-level analytics isn’t switched on for your team.
The connection shows Key rejected, or the connect window (or the provider’s page in Settings) says “This key can’t list your people”. The key lost its Teams Read-only permission or was removed, or Windsurf refused it when Flowstate asked for your people. Add a new service key with Teams Read-only permission, then select Replace key on the connection, or Replace the key beside the message. Paste it and select Verify and connect.
Last month’s credits are missing. Windsurf only reports the current billing cycle.
Someone’s usage isn’t shown against them. Their Windsurf email doesn’t match anyone in Flowstate. Add them or correct their email, or match them by hand under Settings → Integrations → User attribution.