Files
AutoGPT/docs/platform/integrations-and-credentials.md
Torantulino 253482ae64 docs: add user-facing platform documentation
Adds 11 new documentation pages covering the hosted platform user
experience, filling the gap between the existing developer-focused
docs and what end users of platform.agpt.co need to know.

New pages: Getting Started (Cloud), AutoPilot, Agent Builder Guide,
Agent Library, Marketplace, Scheduling & Triggers, Templates,
Credits & Billing, Integrations & Credentials, Data Flow & Execution,
Sharing & Exporting Agents.

Restructures SUMMARY.md with a "Using the Platform" section and
updates the overview page to link to both cloud and self-host guides.

Resolves SECRT-1862

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 13:22:59 +01:00

3.2 KiB

Integrations & Credentials

Overview

Many blocks on the AutoGPT Platform integrate with external services like Google, GitHub, Linear, Twitter, and more. These integrations require credentials — such as OAuth connections, API keys, or username/password pairs — to access your accounts on those services.

This guide explains how credentials work on the platform, how to add them, and how to manage them.

How Credentials Work

Platform-Provided Credentials

On the cloud-hosted platform at platform.agpt.co, many credentials are provided by default. Services like OpenAI, Anthropic, and Replicate are pre-configured, so you can use AI blocks and many other features without providing your own API keys.

User-Provided Credentials

For services tied to your personal accounts — such as Google, Linear, GitHub, or Twitter — you'll need to connect your own credentials. This only needs to be done once per service per account. After connecting, all agents that use that service will automatically have access.

Adding Credentials

Credentials are added in context — when you encounter a block that needs them, rather than from a central setup page.

When Building an Agent

If you add a block to the builder that requires a credential you haven't connected yet, a credential bar will appear on the block prompting you to add it.

When Running an Agent

If you run an agent (including marketplace agents) that requires credentials, one of the input fields will be the credential selector. This only appears for services you haven't connected yet.

Credential Types

Depending on the service, you'll be prompted to authenticate in one of three ways:

Type Description Example Services
OAuth Click to authorise via the service's login page Google, GitHub, Twitter
API Key Paste your API key from the service's dashboard Linear, OpenAI (if self-hosting)
Username & Password Enter your account credentials Varies by service

{% hint style="info" %} You only need to connect a credential once per service. For example, after adding your Linear API key, every agent that uses Linear blocks will have access automatically. {% endhint %}

Managing Credentials

Viewing Connected Integrations

To view and manage your connected integrations:

  1. Click your profile picture in the top-right corner
  2. Select Integrations
  3. You'll see a list of all your connected integrations

URL: platform.agpt.co/profile/integrations

Removing a Credential

From the integrations page, you can browse your list of connected integrations and delete any you no longer need.

{% hint style="warning" %} You cannot add new integrations from the integrations management screen. New credentials are only added when you encounter a block or agent that requires them. {% endhint %}

Self-Hosted Credentials

If you're running the platform locally via self-hosting, you'll need to provide your own API keys for all services, including AI providers. These are configured in the autogpt_platform/backend/.env file. See the Self-Hosting Guide for details.