Skip to main content
GET
/
integrations
/
status
/
{externalUserIdentifier}
Get Integration Status
curl --request GET \
  --url https://api.example.com/integrations/status/{externalUserIdentifier}
[
  {
    "type": "google-analytics",
    "enabled": true,
    "connected": true,
    "lastSynced": "2024-02-20T15:30:00Z",
    "propertyId": "123456789",
    "syncSchedule": "0 */6 * * *"
  },
  {
    "type": "notion",
    "enabled": true,
    "connected": true,
    "lastSynced": "2024-02-20T15:00:00Z",
    "workspaceName": "My Workspace",
    "syncSchedule": "0 */12 * * *"
  },
  {
    "type": "zoho",
    "enabled": true,
    "connected": true,
    "lastSynced": "2024-02-20T14:45:00Z",
    "organizationId": "org-123",
    "dc": "com",
    "enabledModules": {
      "crm": true,
      "books": true,
      "projects": true
    },
    "syncSchedule": "0 */4 * * *"
  }
]
Get the current status and configuration of all integrations for a specific user.

​
URL Parameters

​
externalUserIdentifier
string
required
Unique identifier for the user in your system

​
Response

​
integrations
array
List of integration statuses
{
  type: string
  enabled: boolean
  connected: boolean
  lastSynced: string
  // Additional fields vary by integration type
}[]

​
Integration-Specific Fields

​
Google Analytics

​
propertyId
string
Selected Google Analytics property ID
​
syncSchedule
string
Data sync schedule

​
Notion

​
workspaceName
string
Connected Notion workspace name
​
syncSchedule
string
Data sync schedule

​
Slack

​
teamId
string
Connected Slack team ID
​
syncSchedule
string
Data sync schedule

​
Zoho

​
organizationId
string
Connected Zoho organization ID
​
dc
string
Zoho data center
​
enabledModules
object
Enabled Zoho modules
{
  crm: boolean
  books: boolean
  projects: boolean
}
​
syncSchedule
string
Data sync schedule

​
Example

curl https://suada.ai/api/public/integrations/status/user-123 \
  -H "Authorization: Bearer sk-suada-your-api-key"

[
  {
    "type": "google-analytics",
    "enabled": true,
    "connected": true,
    "lastSynced": "2024-02-20T15:30:00Z",
    "propertyId": "123456789",
    "syncSchedule": "0 */6 * * *"
  },
  {
    "type": "notion",
    "enabled": true,
    "connected": true,
    "lastSynced": "2024-02-20T15:00:00Z",
    "workspaceName": "My Workspace",
    "syncSchedule": "0 */12 * * *"
  },
  {
    "type": "zoho",
    "enabled": true,
    "connected": true,
    "lastSynced": "2024-02-20T14:45:00Z",
    "organizationId": "org-123",
    "dc": "com",
    "enabledModules": {
      "crm": true,
      "books": true,
      "projects": true
    },
    "syncSchedule": "0 */4 * * *"
  }
]

​
Error Codes

​
401
object
Authentication error
{
  "error": "Invalid or expired API key"
}
​
404
object
User not found
{
  "error": "User not found"
}
​
500
object
Server error
{
  "error": "Failed to get integration status"
}

​
Notes

  • The response includes all available integrations, whether connected or not
  • The lastSynced timestamp indicates when data was last synchronized
  • The syncSchedule is in cron format
  • Each integration type may have additional fields specific to its configuration
  • The enabled field indicates whether the integration is currently active
  • The connected field indicates whether the OAuth connection is valid