Skip to main content
POST
/
integrations
/
{integrationType}
/
callback
Integration Callback
curl --request POST \
  --url https://api.example.com/integrations/{integrationType}/callback \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "state": "<string>"
}
'
{
  "success": true,
  "message": "Notion workspace connected successfully",
  "workspace": {
    "id": "workspace-id",
    "name": "My Workspace",
    "icon": "https://notion.so/icons/workspace.png"
  },
  "passthroughRedirectUri": "https://your-app.com/oauth/callback"
}
Complete the OAuth flow for a third-party integration.

​
URL Parameters

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

​
Request

​
code
string
required
The OAuth authorization code
​
state
string
required
The state parameter from the OAuth flow

​
Response

The response format varies by integration type:

​
Google Analytics

​
success
boolean
Whether the callback was successful
​
message
string
Success or error message
​
properties
array
List of available Google Analytics properties
{
  id: string
  name: string
  websiteUrl: string
}[]
​
temporaryAccessToken
string
Temporary token for property selection
​
passthroughRedirectUri
string
The redirect URI provided during connection

​
Notion

​
success
boolean
Whether the callback was successful
​
message
string
Success or error message
​
workspace
object
Connected Notion workspace details
{
  id: string
  name: string
  icon: string
}
​
passthroughRedirectUri
string
The redirect URI provided during connection

​
Slack

​
success
boolean
Whether the callback was successful
​
message
string
Success or error message
​
team
object
Connected Slack team details
{
  id: string
  name: string
  domain: string
}
​
passthroughRedirectUri
string
The redirect URI provided during connection

​
Zoho

​
success
boolean
Whether the callback was successful
​
message
string
Success or error message
​
organization
object
Connected Zoho organization details
{
  id: string
  name: string
  modules: string[]
}
​
passthroughRedirectUri
string
The redirect URI provided during connection

​
Gmail

​
success
boolean
Whether the callback was successful
​
message
string
Success or error message
​
passthroughRedirectUri
string
The redirect URI provided during connection

​
Example

curl -X POST https://suada.ai/api/public/integrations/notion/callback \
  -H "Content-Type: application/json" \
  -d '{
    "code": "oauth-code-from-provider",
    "state": "oauth-state-from-provider"
  }'

{
  "success": true,
  "message": "Notion workspace connected successfully",
  "workspace": {
    "id": "workspace-id",
    "name": "My Workspace",
    "icon": "https://notion.so/icons/workspace.png"
  },
  "passthroughRedirectUri": "https://your-app.com/oauth/callback"
}

​
Error Codes

​
400
object
Invalid request
{
  "error": "Missing required parameters"
}
​
401
object
Invalid OAuth code or state
{
  "error": "Invalid OAuth code"
}
​
500
object
Server error
{
  "error": "Failed to complete OAuth flow"
}

​
Notes

  • This endpoint should be called after receiving the OAuth callback from the integration provider
  • The state parameter is used to verify the OAuth flow and prevent CSRF attacks
  • For Google Analytics, you’ll need to make an additional call to select a property
  • After successful callback, redirect the user to the passthroughRedirectUri provided during connection
  • The integration will be automatically enabled for the user after successful callback