Api reference
Update payment mappings
Replace the full set of payment-method mappings between RevKeen's internal payment methods and the external provider's payment modes. Used to control how reconciled payments are tagged on the provider side. The mapping set is applied atomically — partial updates are not supported.
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 syncGET /integrations— List all integrationsPUT /integrations/{provider}/status— Update integration statusPUT /integrations/{provider}/sync-toggle— Toggle integration sync
Common errors
404 resource_missing— the referenced resource does not exist or is not visible to your key.
Idempotency
Pass an Idempotency-Key header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see the idempotency guide.
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
Value in
"practicehub" | "wodify" | "terminal"Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X PUT "https://api.revkeen.com/v2/integrations/practicehub/payment-mappings" \ -H "x-api-key: $REVKEEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "mappings": [ { "id": "string", "revkeenMethod": "string", "practiceHubMethodId": "string" } ] }'{
"success": true
}Empty