Configure Credentials for an Agent

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

Written By Philippe

Last updated 4 days 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. Builder Keys (Tier 1) — Highest priority; used whenever the builder has pre-configured that credential. Shown as locked — you cannot override it
  2. Your Keys (Tier 2) — Used for every credential the builder left open, when you connect your own (BYOK)
  3. Platform Keys (Tier 3) — Fallback when neither of the above are available

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

SourcePriorityWhen Used
🤝 Builder pre-configured1st (highest)Whenever the builder connected that credential — locked, not overridable
🔑 Your credentials (BYOK)2ndFor credentials the builder left open, when you connect your own
🏢 Platform-provided3rd (fallback)When above are unavailable, and the agent does not include AI usage in its price

Platform-provided keys are not available on every agent. They are withdrawn onagents offering free trials, and on agents whose Builder includes AI usage in theprice — in both cases nobody is funding that usage, so the agent runs on its ownkeys or not at all.

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 secure sandbox. See: Credentials System Deep Dive.