Configure Credentials for an Agent

Step-by-step guide to connecting API keys and OAuth credentials for an agent you purchased.

Written By pvdyck

Last updated About 1 hour ago

Configure Credentials for an Agent

Some agents require API keys or OAuth connections before they can run. This guide shows you how to configure them.

Credential Configuration Flow:

  1. Browse → Find an agent
  2. Purchase → Buy the agent
  3. Configure → Add your API keys or connect OAuth
  4. Ready → Run the agent

Configuration options:

  • Paste API key manually
  • Connect via OAuth (one-click authorization)

Do I Always Need to Configure Credentials?

No. There are three ways credentials can be provided:

Credential Priority:

  1. Your Keys (Tier 1) — Highest priority, used first
  2. Builder Keys (Tier 2) — Used when you haven't provided your own
  3. Platform Keys (Tier 3) — Fallback when above are unavailable

The system checks in order and uses the first available credential source.

SourcePriorityWhen Used
🔑 Your credentials1st (highest)When you provide your own API keys
🤝 Builder pre-configured2ndWhen you haven't provided your own
🏢 Platform-provided3rd (fallback)When above are unavailable

If your agent card shows "needs-config", it's waiting for your credentials.

How to Configure

StepAction
1.From your Producer Dashboard, find the agent card
2.Click Configure (or the ⚙️ icon)
3.The credential modal shows all required services
4.For each service:
   • API key: paste your key in the input field
   • OAuth: click "Connect [Service]" and complete OAuth flow
5.Click Save Credentials
6.Agent card status changes to "ready"

Where to Find Your API Keys

ServiceWhere to Find
OpenAIplatform.openai.com → API Keys
Slackapi.slack.com → Your Apps → OAuth Tokens
GitHubgithub.com → Settings → Developer Settings → Personal Access Tokens
HubSpotapp.hubspot.com → Settings → Integrations → API Keys

Are My Credentials Secure?

Yes. Credentials are stored in the Secure Vault and only decrypted at execution time inside the Cloudflare Worker sandbox. See: Credentials System Deep Dive.

Related