Skip to main content
Credentials let agents access external services like GitHub, Slack, and Jira on behalf of your team. They are configured at the organization level and shared across all workspaces.

​
Connecting a service

  1. Go to your organization at app.guild.ai
  2. Open Settings > Credentials
  3. Click Connect next to the service you want to add
  4. Complete the OAuth flow to authorize Guild

​
Supported services

ServiceAuthentication
GitHubOAuth
SlackOAuth
JiraOAuth
BitbucketOAuth
Azure DevOpsOAuth
ConfluenceOAuth
FigmaOAuth
New RelicAPI key
CypressAPI key
TestRailAPI key

​
How agents use credentials

When an agent calls a service tool (e.g. github_issues_get), the runtime automatically provides the organization’s credentials. The agent code doesn’t handle authentication directly. If an agent needs a credential that hasn’t been connected, it can request one using guild_credentials_request from guildTools: 
await task.guild?.credentials_request({
  service: "github",
})
The user is prompted to connect the service before the agent continues.

​
Managing credentials

Credentials can be disconnected and reconnected at any time from Settings > Credentials. Disconnecting a credential will prevent agents from accessing that service until it’s reconnected. LLM Settings (next in the Settings sidebar) configures LLM providers and API keys separately from service credentials. See LLM settings.