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 21 hours ago

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

Credential Configuration Flow:

Configuration options:

Do I Always Need to Configure Credentials?

No. There are three ways credentials can be provided:

Credential Priority:

Your Keys (Tier 1) — Highest priority; used first when you connect your own API keys (BYOK)
Builder Keys (Tier 2) — Used when the builder has pre-configured credentials and you haven't connected your own
Platform Keys (Tier 3) — Fallback when neither of the above are available

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

Source	Priority	When Used
🔑 Your credentials (BYOK)	1st (highest)	When you connect your own API keys
🤝 Builder pre-configured	2nd	When the builder has pre-configured credentials and you haven't connected your own
🏢 Platform-provided	3rd (fallback)	When above are unavailable

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

Step	Action
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"

Service	Where to Find
OpenAI	platform.openai.com → API Keys
Slack	api.slack.com → Your Apps → OAuth Tokens
GitHub	github.com → Settings → Developer Settings → Personal Access Tokens
HubSpot	app.hubspot.com → Settings → Integrations → API Keys

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