Configuring Integrations

Step-by-step guide to setting up integrations.

Overview

This guide walks through configuring integrations to proxy API requests through agntdata.

Prerequisites

Before configuring an integration, you’ll need:

• An agntdata account with an active workspace
• An account with the external service
• An API key for the external service

Configuration Steps

Step 1: Navigate to Integrations

From the agntdata dashboard:

1. Click Integrations in the sidebar
2. Click Add Integration
3. Select the provider you want to configure

Step 2: Add Your API Key

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

Your API key is encrypted and stored securely.

Step 3: Use the Integration

Make requests through agntdata using your agntdata API key:

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

agntdata proxies the request to the external service using your stored API key.

Managing Integrations

Viewing Integrations

The Integrations page shows all configured integrations for your workspace.

Updating Credentials

To update the API key for an integration:

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

Disabling Integrations

To temporarily disable an integration:

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

Deleting Integrations

Deleting an integration removes the stored credentials permanently.

1. Click on the integration
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 integration keys 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

Integrations Overview

Learn how integrations work.

Webhooks

Set up incoming webhooks.