PMS mapping

For partners whose own browser integration writes notes into a PMS form. Not needed to submit consults or read notes back, and most integrations never touch it.

Mint a short-lived token for a browser integration

POST/v1/pms-sync/session

Exchanges your connection token for a mapping-session token that is safe to hand to a browser.

Only for partners running their own in-browser PMS integration through the WisePaws mapping service. If you submit consults and read notes back, you do not need this.

Your connection token is long-lived and must never leave your backend. Call this server to server and pass only the returned token to the browser; it expires in 15 minutes and is scoped to the one vet and practice the connection already identifies.

Responses

Every failure below returns the Error shape.

200

A mapping session.

Returns MappingSession.

401Unauthorized

The token is missing, malformed, or no longer valid. connection_revoked means the vet disconnected or left the practice, so clear the stored token and send them through the connect flow again.

partner_disabled is different and reconnecting will not fix it: your integration itself is switched off, and every token you hold stops at once. Stop retrying and contact us.

402

The practice does not have an active WisePaws subscription.

{
  "error": "An active WisePaws subscription is required",
  "code": "subscription_inactive"
}

403

The vet is no longer a member of that practice. Their connection should already have been revoked when they left, so this is the backstop; the remedy is the same as connection_revoked at 401. Clear the stored token and send them through the connect flow again.

{
  "error": "Not a member of this workspace",
  "code": "connection_revoked"
}

502Server Error

Something failed on our side before your request could be judged. Retry shortly: nothing was consumed, and no note was created.

503

Sessions cannot be minted right now. Retry shortly; nothing was consumed.

{
  "error": "PMS mapping sessions are unavailable",
  "code": "internal_error"
}