Agentcard

Integrate your application with the Agentcard API

Quickstart

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

Create the integration

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

Connect Agentcard

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

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:

curl "https://api.tenklo.dev/proxy/api/v2" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Or fetch credentials with the Node SDK or API.

You're connected! Check the Logs tab in Tenklo to inspect requests.

Implement Tenklo in your app

Follow our Auth implementation guide to integrate Tenklo in your app.

To obtain your own production credentials, follow the setup guide linked below.

Agentcard integration guides

Tenklo 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

On this page