Skip to main content

​
GET /v1/integrations

List all integrations configured for the current workspace. 
curl https://api.flokit.ai/v1/integrations \
  -H "Authorization: Bearer $FLOKIT_API_KEY"

​
Response

{
  "integrations": [
    {
      "id": "int_01hx4j7revenuecat",
      "type": "revenuecat",
      "status": "connected",
      "last_synced_at": "2024-03-15T13:00:00Z",
      "error_message": null
    },
    {
      "id": "int_01hx4j7appsflyer",
      "type": "appsflyer",
      "status": "connected",
      "last_synced_at": "2024-03-15T12:45:00Z",
      "error_message": null
    },
    {
      "id": "int_01hx4j7stripe",
      "type": "stripe",
      "status": "error",
      "last_synced_at": "2024-03-14T22:00:00Z",
      "error_message": "Webhook signature verification failed — check your signing secret"
    }
  ]
}

​
Integration object fields

FieldTypeDescription
idstringUnique integration identifier
typestringIntegration type: revenuecat, adapty, appsflyer, adjust, stripe, app_store_connect, google_play, warehouse
statusstringconnected, error, syncing, or disconnected
last_synced_atstringISO 8601 timestamp of the last successful sync
error_messagestring | nullError detail when status is error; null otherwise

​
GET /v1/integrations/

Get full details for a specific integration, including sync statistics. 
curl https://api.flokit.ai/v1/integrations/int_01hx4j7revenuecat \
  -H "Authorization: Bearer $FLOKIT_API_KEY"

​
Response

{
  "integration": {
    "id": "int_01hx4j7revenuecat",
    "type": "revenuecat",
    "status": "connected",
    "last_synced_at": "2024-03-15T13:00:00Z",
    "error_message": null,
    "sync_stats": {
      "events_last_24h": 4821,
      "events_total": 1204739,
      "earliest_event_at": "2023-08-01T00:00:00Z"
    }
  }
}

​
POST /v1/integrations//sync

Trigger a manual sync for an integration. Useful after configuration changes or to recover from a sync error without waiting for the next scheduled sync. 
curl -X POST https://api.flokit.ai/v1/integrations/int_01hx4j7stripe/sync \
  -H "Authorization: Bearer $FLOKIT_API_KEY"

​
Response

{
  "status": "ok",
  "sync_id": "sync_01hx4j7k9m2n3p5q6r8s"
}
The sync runs asynchronously. Check the integration status via GET /v1/integrations/{id} or subscribe to integration.error webhooks to be notified of sync failures.