Api reference
List all integrations
Return every integration configured for the authenticated merchant, active or not. Used by the integrations dashboard to render the connection grid. Each entry includes activation state, last sync timestamp, and the provider's display metadata.
Related endpoints
POST /integrations/{provider}/activate— Activate integrationPOST /integrations/{provider}/deactivate— Deactivate integrationGET /integrations/{provider}— Get integration statusPOST /integrations/{provider}/test— Test integration credentialsPOST /integrations/{provider}/sync— Trigger manual syncPUT /integrations/{provider}/status— Update integration statusPUT /integrations/{provider}/sync-toggle— Toggle integration syncPUT /integrations/{provider}/sync-interval— Update sync interval
Common errors
401 unauthenticated— missing, malformed, or revoked API key.
Pagination
Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.
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
Response Body
application/json
curl "https://api.revkeen.com/v2/integrations" \ -H "x-api-key: $REVKEEN_API_KEY"{
"data": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"provider": "practicehub",
"isActive": true,
"syncEnabled": true,
"status": "connected",
"lastSyncAt": "2019-08-24T14:15:22Z",
"lastSyncError": "string",
"syncHealth": "healthy",
"providerState": {
"consecutiveErrors": 0,
"lastErrorAt": "string",
"lastSyncAt": "string",
"mode": "string"
},
"syncInterval": {
"hasRepeatableJob": true,
"intervalMs": 0,
"nextRun": "2019-08-24T14:15:22Z"
},
"configuration": {
"property1": null,
"property2": null
},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
]
}Empty