Skip to main content

Quickstart

Connect to Agentcard with Nango and see data flow in 2 minutes. The Agentcard API uses OAuth 2.0 client credentials, so no user redirect is required.
1

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Agentcard.
2

Connect Agentcard

Go to Connections -> Add Test Connection. Enter your Client ID and Client Secret, then save.
3

Call the Agentcard API

Let’s make your first request to the Agentcard API: introspect the credential, which returns your organization and mode. Replace the placeholders below with your API key, integration ID, and connection ID:
Or fetch credentials with the Node SDK or API.You’re connected! Check the Logs tab in Nango to inspect requests.
4

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

Agentcard integration guides

Nango maintained guides for common use cases. Official docs: Agentcard API docs

Common scopes

Agentcard does not use scopes. Access is determined by the OAuth client’s organization and mode (sandbox or production).

API gotchas

  • The credential decides the environment: a sandbox client returns sandbox data and a production client returns live data. The API base URL is always https://api.agentcard.sh.
  • The public surface is /api/v2, including the token endpoint POST /api/v2/oauth/token. /api/v1 paths are internal and return endpoint_retired.
  • Agentcard is a payments product for AI agents (one-time virtual cards with spend caps and approvals). Card mints move real money in production; test in sandbox first. Amounts are in cents (2500 = $25.00).
Contribute API gotchas by editing this page