TeamCity

Connect your TeamCity server to BuildButler to import build configurations, test results, and pipeline data.

Generate a TeamCity Access Token

1. Log in to TeamCity and click your username in the top-right corner.
2. Go to Profile → Access Tokens.
3. Click Create access token.
4. Give it a name like buildbutler.
5. Set the appropriate permissions (see Permissions required below).
6. Click Create and copy the token.

Add the connection in BuildButler

Navigate to Settings → Integrations → Add TeamCity Connection and fill in the form:

{
  "name": "Production TeamCity",
  "url": "https://teamcity.example.com",
  "token": "eyJ0eXAiOiJU..."
}

Click Test Connection to verify. BuildButler will call the TeamCity REST API and confirm it can access your build configurations.

Build configuration selection

After connecting, BuildButler will list all accessible build configurations. Select the ones you want to monitor. BuildButler will:

• Import build results and history
• Track test results across builds
• Monitor build queue and agent status
• Collect build logs for analysis

Data mapping

TeamCity concepts map to BuildButler as follows:

Permissions required

The access token needs the following permissions:

Multiple instances

You can connect as many TeamCity servers as you like. Each connection syncs independently and appears as a separate source in the dashboard filter bar.

Troubleshooting