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 1 day 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.