string
required
The unique identifier of the integration to connect to
API Key Authentication
For integrations that use API key authentication (like Perplexity):curl -X POST "https://api.incredible.one/v1/integrations/{integration_id}/connect" \
-H "Content-Type: application/json" \
-d '{"user_id":"user_123","api_key":"YOUR_API_KEY"}'
import requests
resp = requests.post(
"https://api.incredible.one/v1/integrations/{integration_id}/connect",
json={"user_id": "user_123", "api_key": "YOUR_API_KEY"},
)
print(resp.json())
const res = await fetch("https://api.incredible.one/v1/integrations/{integration_id}/connect", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ user_id: "user_123", api_key: "YOUR_API_KEY" })
});
console.log(await res.json());
{
"user_id": "user_123",
"api_key": "your_api_key_here"
}
{
"success": true,
"message": "Successfully connected to Perplexity",
"integration_id": "perplexity",
"user_id": "user_123"
}
OAuth Authentication
For integrations that use OAuth authentication (like Gmail):curl -X POST "https://api.incredible.one/v1/integrations/{integration_id}/connect" \
-H "Content-Type: application/json" \
-d '{"user_id":"user_123","callback_url":"https://your.app/oauth/callback"}'
import requests
resp = requests.post(
"https://api.incredible.one/v1/integrations/{integration_id}/connect",
json={"user_id": "user_123", "callback_url": "https://your.app/oauth/callback"},
)
print(resp.json())
const res = await fetch("https://api.incredible.one/v1/integrations/{integration_id}/connect", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ user_id: "user_123", callback_url: "https://your.app/oauth/callback" })
});
console.log(await res.json());
{
"user_id": "user_123",
"callback_url": "https://backend.viss.ai/app-auth/oauth2-callback"
}
{
"redirect_url": "https://auth.composio.com/oauth/authorize?client_id=...",
"instructions": "Please visit the redirect URL to complete OAuth authentication"
}
Error Responses
{
"error": "User ID required",
"instructions": "Please provide user_id in request body"
}
{
"error": "API key required",
"instructions": "Please provide your Gmail API key in the request body"
}