RevKeenDocs

Get integration status

Return the current configuration snapshot for a provider — activation state, last sync timestamp, next scheduled sync, sync interval, auto-send setting, invoice lookback window, and circuit-breaker error count. Does not trigger a sync or a credential test; use /sync or /test for those.


Related endpoints

  • POST /integrations/{provider}/activate — Activate integration
  • POST /integrations/{provider}/deactivate — Deactivate integration
  • POST /integrations/{provider}/test — Test integration credentials
  • POST /integrations/{provider}/sync — Trigger manual sync
  • GET /integrations — List all integrations
  • PUT /integrations/{provider}/status — Update integration status
  • PUT /integrations/{provider}/sync-toggle — Toggle integration sync
  • PUT /integrations/{provider}/sync-interval — Update sync interval

Common errors

  • 401 unauthenticated — missing, malformed, or revoked API key.
GET
/integrations/{provider}
x-api-key<token>

Your RevKeen API key (powered by Unkey). Get it from Dashboard > Settings > API Keys. Use rk_sandbox_* for test mode and rk_live_* for production.

In: header

Path Parameters

provider*string

External system provider (practicehub, wodify, terminal, hubspot).

Value in"practicehub" | "wodify" | "terminal" | "hubspot"

Response Body

application/json

application/json

application/json

Stuck on an error response? Ask the RevKeen assistant to explain it.
curl "https://api.revkeen.com/v2/integrations/practicehub" \
  -H "x-api-key: $REVKEEN_API_KEY"
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "provider": "practicehub",
    "is_active": true,
    "sync_enabled": true,
    "status": "connected",
    "last_sync_at": "2019-08-24T14:15:22Z",
    "last_sync_error": "string",
    "sync_health": "healthy",
    "provider_state": {
      "consecutive_errors": 0,
      "last_error_at": "string",
      "last_sync_at": "string",
      "mode": "string"
    },
    "sync_interval": {
      "has_repeatable_job": true,
      "interval_ms": 0,
      "next_run": "2019-08-24T14:15:22Z"
    },
    "configuration": {
      "property1": null,
      "property2": null
    },
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  }
}
{
  "error": "string"
}
{
  "error": "string"
}