Configuring Connections

Step-by-step guide to setting up connections.

Overview

This guide walks through configuring connections to proxy API requests through agntdata using your own vendor credentials.

Prerequisites

Before configuring a connection, you’ll need:

• An agntdata account with an active workspace
• An account with the external service
• An API key for the external service (or the ability to complete the vendor’s OAuth flow)

Configuration Steps

Step 1: Navigate to Connections

From the agntdata dashboard:

1. Click Connections in the sidebar
2. Click Add Connection
3. Select the vendor you want to configure

Step 2: Add Your Credentials

For API-key vendors:

1. Generate an API key in the vendor’s dashboard
2. Paste it into the agntdata configuration form
3. Optionally add a name to identify this credential
4. Click Save

For OAuth vendors:

1. Click Connect
2. Complete the vendor’s OAuth consent flow
3. You’ll be redirected back to agntdata once the install is recorded

Your credentials are encrypted and stored securely.

Step 3: Use the Connection

Make requests through agntdata using your agntdata API key:

curl -X GET "https://api.agntdata.dev/v1/connections/:vendor/endpoint" \
  -H "Authorization: Bearer YOUR_AGNTDATA_API_KEY"

agntdata proxies the request to the external service using your stored credentials.

Managing Connections

Viewing Connections

The Connections page shows all configured connections for your workspace.

Updating Credentials

To update the API key for a connection:

1. Click on the connection
2. Enter the new API key
3. Click Save

Disabling Connections

To temporarily disable a connection:

1. Click on the connection
2. Toggle Active to off

Deleting Connections

Deleting a connection removes the stored credentials permanently.

1. Click on the connection
2. Click Delete
3. Confirm the deletion

Troubleshooting

401/403 Errors

• Verify your external service API key is correct
• Check if the API key has the required permissions
• Ensure the API key hasn’t been revoked

Rate Limit Errors

External services have their own rate limits. Check the external service’s documentation for limits and best practices.

Connection Timeout

• The external service may be experiencing issues
• Try the request again after a short delay

Best Practices

Use Descriptive Names

Give your connection credentials descriptive names to identify them easily.

Limit Permissions

When generating API keys for external services, only grant the minimum permissions required.

Rotate Keys Periodically

Periodically rotate your external service API keys for security.

Next Steps

Connections Overview

Learn how connections work.

Webhooks

Set up incoming webhooks.