Skip to main content
POST
/
integrations
/
{integrationType}
/
connect
Connect Integration
curl --request POST \
  --url https://api.example.com/integrations/{integrationType}/connect \
  --header 'Content-Type: application/json' \
  --data '
{
  "externalUserIdentifier": "<string>",
  "passthroughRedirectUri": "<string>",
  "dc": "<string>",
  "scopes": [
    "<string>"
  ]
}
'
{
  "authUrl": "https://api.notion.com/v1/oauth/authorize?client_id=..."
}
Start the OAuth flow to connect a third-party integration.

​
URL Parameters

​
integrationType
string
required
The type of integration to connect. Valid values:
  • google-analytics
  • notion
  • slack
  • zoho
  • gmail

​
Request

​
externalUserIdentifier
string
required
Unique identifier for the user in your system
​
passthroughRedirectUri
string
required
The URL to redirect to after OAuth completion
​
dc
string
Data center for Zoho integration (e.g., ‘com’, ‘eu’)
​
scopes
string[]
Additional OAuth scopes for Zoho integration

​
Response

​
authUrl
string
The OAuth authorization URL to redirect the user to

​
Example

curl -X POST https://suada.ai/api/public/integrations/notion/connect \
  -H "Authorization: Bearer sk-suada-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "externalUserIdentifier": "user-123",
    "passthroughRedirectUri": "https://your-app.com/oauth/callback"
  }'

{
  "authUrl": "https://api.notion.com/v1/oauth/authorize?client_id=..."
}

​
Integration-Specific Parameters

​
Google Analytics

No additional parameters required.

​
Notion

No additional parameters required.

​
Slack

No additional parameters required.

​
Zoho

​
dc
string
default:"com"
Zoho data center:
  • com - US data center
  • eu - EU data center
  • in - India data center
  • com.cn - China data center
  • com.au - Australia data center
​
scopes
string[]
List of Zoho API scopes to request. Default scopes include:
  • ZohoCRM.modules.ALL
  • ZohoBooks.fullaccess.ALL
  • ZohoProjects.projects.ALL

​
Gmail

No additional parameters required.

​
Error Codes

​
400
object
Invalid request
{
  "error": "Missing required parameters"
}
​
401
object
Authentication error
{
  "error": "Invalid or expired API key"
}
​
500
object
Server error
{
  "error": "Failed to initialize OAuth flow"
}

​
Notes

  • The OAuth flow is a multi-step process:
    1. Call this endpoint to get the authorization URL
    2. Redirect the user to the authorization URL
    3. User authorizes your application
    4. Integration provider redirects to your callback URL
    5. Call the callback endpoint to complete the flow
  • The passthroughRedirectUri should be a URL in your application that can handle the OAuth callback
  • Store the externalUserIdentifier to associate the integration with the correct user after the callback