Windsurf
Permissions
The person logging in to Windsurf to generate the Service Key must have a role that includes Service Key Create permissions.
Have a team member with the built-in Admin role generate it. Admins have all permissions enabled by default. Alternatively, if a non-admin is to create a key, they must be assigned a custom role that explicitly has the Service Key Create permission enabled under the Service Key settings category.
To feed Flow's AI activity dashboards, the service key should be scoped with read-only access to your organization's metadata and telemetry. You will want to look for and check these specific permissions:
analytics read: Allows Flow to ingest your team's usage activity and dashboard data.teams read-only: Allows Flow to see user lists and team mappings so it can match Windsurf activity to the right developers in your Flow workspace.
Create your integration
To connect Windsurf to Flow, you will need to mint a Service key for your organization.
Log in to your Windsurf/Codeium Team account via your browser.
Navigate to your Team Settings or Organization Dashboard.
Locate the Service Keys (or API Keys) section in the navigation menu.
Click Create New Service Key.
Provide a clear description (for example, Appfire Flow Integration) and select the appropriate read permissions for the repo and usage data.
Copy the key immediately. For security, Windsurf will display this string of characters only once.
Once your Windsurf Service key is copied and secured, you can now use it to connect Windsurf to Flow.
Click Settings in the top navigation.
In the left navigation under Integrations, click Integrations.
Click Add integration.
Click Windsurf in the Integration Provider list.
Paste the Service key in the Service key field.
Click Test connection. If the connection was successful, you'll see the success message.
Click Next.
Name your integration. This is the name Flow will display for the integration. Choose a name that will help you identify the integration later.
Once you've completed all sections, click Create.