Save product mappings

Replace the full product-mapping set atomically. The request body is treated as the desired end state — any existing mapping not in the payload is deleted. To change a single mapping without affecting others, read first via `GET` then send the merged set back. Use `DELETE` for single-mapping removal. --- **Related endpoints** - `POST /integrations/{provider}/activate` — Activate integration - `POST /integrations/{provider}/deactivate` — Deactivate integration - `GET /integrations/{provider}` — Get integration status - `POST /integrations/{provider}/test` — Test integration credentials - `POST /integrations/{provider}/rotate` — Rotate integration credentials - `POST /integrations/{provider}/sync` — Trigger manual sync - `POST /integrations/{provider}/invoices/{externalInvoiceId}/refresh` — Refresh a single PracticeHub invoice - `GET /integrations/{provider}/invoices/{externalInvoiceId}/refresh-status` — Get demand invoice refresh status **Common errors** - `400 invalid_request` — malformed payload or failed validation. - `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](/docs/fundamentals/idempotency).

Related endpoints

POST /integrations/{provider}/activate — Activate integration
POST /integrations/{provider}/deactivate — Deactivate integration
GET /integrations/{provider} — Get integration status
POST /integrations/{provider}/test — Test integration credentials
POST /integrations/{provider}/rotate — Rotate integration credentials
POST /integrations/{provider}/sync — Trigger manual sync
POST /integrations/{provider}/invoices/{externalInvoiceId}/refresh — Refresh a single PracticeHub invoice
GET /integrations/{provider}/invoices/{externalInvoiceId}/refresh-status — Get demand invoice refresh status

Common errors

400 invalid_request — malformed payload or failed validation.
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.

Authorization

x-api-key<token>

Your RevKeen merchant API key. Create and manage keys in Dashboard → Settings → Developer. Use rk_sandbox_* for staging/test and rk_live_* for production. The same key may be sent as Authorization: Bearer <key> if that suits your HTTP client better. A missing, invalid, expired, or revoked key returns 401 with a WWW-Authenticate: Bearer challenge; a valid key without the required scope returns 403.

In: header

Path Parameters

provider*string

Providers that persist product mappings. TeamUp mappings must be zero-money memberships.

Value in

"practicehub"
"wodify"
"terminal"
"teamup"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

mappings*array<>

Response Body

`application/json`

Stuck on an error response? Ask the RevKeen assistant to explain it.

curl -X PUT "https://api.revkeen.com/v2/integrations/practicehub/product-mappings" \
  -H "x-api-key: $REVKEEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mappings": [
      {
        "externalId": "string",
        "internalId": null,
        "ignored": false,
        "metadata": {
          "name": "string",
          "type": "string",
          "charge_type": "string"
        }
      }
    ]
  }'

{  "success": true,  "count": 0}

Save product mappings

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

404application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`