> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Credentials

> Connect third-party services so agents can authenticate automatically.

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](https://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

| Service      | Authentication |
| ------------ | -------------- |
| GitHub       | OAuth          |
| Slack        | OAuth          |
| Jira         | OAuth          |
| Azure DevOps | OAuth          |
| Confluence   | OAuth          |
| New Relic    | API key        |
| Cypress      | API key        |
| TestRail     | API 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`](/sdk/tools):

```typescript theme={null}
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.

## Related settings

**LLM Settings** (next in the Settings sidebar) configures LLM providers and API keys separately from service credentials. See [LLM settings](/platform/llm-settings).