Skip to main content

​
Get Integration Status

Check the connection status of a specific integration.
​
provider
string
required
Integration provider: google, hubspot, or intercom
​
workspaceId
string
required
Your workspace domain

​
Request

curl -X GET "https://api.gostanna.com/api/integrations/google/status?workspaceId=yourcompany.com" \
  -H "Authorization: Bearer sk-your-api-key-here"

​
Response

{
  "connected": true,
  "provider": "google",
  "workspaceId": "yourcompany.com",
  "email": "admin@yourcompany.com",
  "expiresAt": "2024-06-01T00:00:00Z",
  "hasRefresh": true,
  "lastSyncAt": "2024-01-31T10:30:00Z",
  "scope": "gmail.readonly calendar.readonly"
}

​
Trigger Integration Sync

Manually trigger a data sync for an integration.
​
provider
string
required
Integration provider: google, hubspot, or intercom
​
workspaceId
string
required
Your workspace domain

​
Request

curl -X POST "https://api.gostanna.com/api/integrations/google/sync" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId": "yourcompany.com"}'

​
Response

{
  "success": true,
  "message": "Sync initiated",
  "syncId": "sync_abc123",
  "startedAt": "2024-01-31T10:30:00Z",
  "estimatedDuration": 300
}

​
Backfill Historical Data

Import historical data from an integration.
​
provider
string
required
Integration provider: google, hubspot, or intercom
​
workspaceId
string
required
Your workspace domain
​
sinceDays
number
required
Number of days of history to import (max: 365)

​
Request

curl -X POST "https://api.gostanna.com/api/integrations/google/backfill" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "yourcompany.com",
    "sinceDays": 90
  }'

​
Response

{
  "success": true,
  "message": "Backfill started",
  "jobId": "job_xyz789",
  "startDate": "2023-11-01T00:00:00Z",
  "endDate": "2024-01-31T23:59:59Z",
  "estimatedRecords": 5000,
  "status": "processing"
}

​
Large-Scale Gmail Ingestion

Perform a large-scale import of Gmail data (Google integration only).
​
workspaceId
string
required
Your workspace domain
​
sinceDays
number
required
Number of days of history to import (max: 365)
​
maxEmails
number
Maximum number of emails to import (default: 10000, max: 50000)
​
batchSize
number
Number of emails per batch (default: 500, max: 1000)

​
Request

curl -X POST "https://api.gostanna.com/api/ingest/v2/start" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "workspaceId": "yourcompany.com",
    "sinceDays": 365,
    "maxEmails": 50000,
    "batchSize": 1000
  }'

​
Response

{
  "success": true,
  "message": "Large-scale ingestion started",
  "sessionId": "session_abc123xyz",
  "config": {
    "workspaceId": "yourcompany.com",
    "sinceDays": 365,
    "maxEmails": 50000,
    "batchSize": 1000,
    "startDate": "2023-02-01T00:00:00Z"
  },
  "status": "initializing",
  "estimatedDuration": "2-4 hours"
}

​
Check Ingestion Status

Monitor the progress of a large-scale ingestion job.
​
workspaceId
string
required
Your workspace domain

​
Request

curl -X GET "https://api.gostanna.com/api/ingest/v2/status?workspaceId=yourcompany.com" \
  -H "Authorization: Bearer sk-your-api-key-here"

​
Response

{
  "sessionId": "session_abc123xyz",
  "status": "processing",
  "progress": {
    "emailsProcessed": 25000,
    "totalEmails": 50000,
    "percentComplete": 50,
    "batchesCompleted": 25,
    "totalBatches": 50
  },
  "timing": {
    "startedAt": "2024-01-31T10:00:00Z",
    "lastUpdateAt": "2024-01-31T12:30:00Z",
    "estimatedCompletionAt": "2024-01-31T14:00:00Z",
    "elapsedSeconds": 9000
  },
  "stats": {
    "clientsIdentified": 85,
    "contactsCreated": 234,
    "interactionsCreated": 24500,
    "errorsCount": 12
  },
  "errors": [
    {
      "timestamp": "2024-01-31T11:15:00Z",
      "message": "Rate limit reached, retrying...",
      "recoverable": true
    }
  ]
}