Connections Overview

Proxy requests to third-party services through agntdata using your own vendor credentials.

What Are Connections?

Connections let you proxy API requests to third-party services through agntdata using your own credentials with each vendor. Store your vendor API keys (or OAuth installs) securely in agntdata and call them with a single agntdata API key — without exposing vendor credentials in your client applications.

Connections are billed by the vendor (you pay the vendor directly). For curated data sources where agntdata pays the vendor and bills you in credits, see Data APIs.

How Connections Work

1. Configure a Connection

   Add your third-party API key (or complete the OAuth flow) for the vendor from the agntdata dashboard.

2. Make Requests

   Call the connection endpoint with your agntdata API key. agntdata proxies the request to the third-party service using your stored credentials.

3. Get Response

   agntdata returns the third-party service response with a consistent envelope.

API Endpoint

Make requests to third-party services through:

GET/POST/PUT/DELETE https://api.agntdata.dev/v1/connections/:vendor/*

agntdata forwards the wildcard path and query parameters to the third-party service.

Example

# Request through agntdata
curl -X GET "https://api.agntdata.dev/v1/connections/instantly/campaigns" \
  -H "Authorization: Bearer YOUR_AGNTDATA_API_KEY"

# Equivalent direct request (requires your Instantly API key)
curl -X GET "https://api.instantly.ai/api/v2/campaigns" \
  -H "Authorization: Bearer YOUR_INSTANTLY_API_KEY"

Response Format

Successful responses include the proxied data:

{
  "success": true,
  "data": {
    // Response from third-party service
  },
  "meta": {
    "vendor": "instantly",
    "cached": false,
    "latencyMs": 245
  }
}

Benefits

Secure Credential Storage

Store third-party API keys in agntdata instead of your client apps. Keys are encrypted at rest.

Unified Authentication

Use one agntdata API key to access multiple services.

Consistent Error Handling

agntdata normalizes error responses from third-party services.

Available Connections

Stripe

Payments, customers, subscriptions, invoices, and checkout sessions.

Linear

Full Linear GraphQL API — issues, projects, cycles, teams, and comments.

Cal.com

Bookings, event types, schedules, and availability on Cal.com v2.

Supabase

Manage your own Supabase organization — projects, SQL, edge functions, secrets, and branches.

More connections (including Attio, Dub, HeyReach, and Instantly) are available in the dashboard.

Next Steps

Configure Connections

Step-by-step setup guide.

Webhooks

Receive data from external services.