Skip to main content

Organization API Overview

The Organization API is the org-scoped external surface on api.propper.ai. It resolves organization-level state from your access token, so the organization is never passed in the path.

↓ OpenAPI JSON

Endpoints​

  • GET /v1/org/entitlements: resolve the calling organization's derived entitlement verdict. The response projection is selected with the view query parameter.

Authentication​

OAuth 2.0 Bearer token; the organization is resolved from the token. Customer integrations request the org:read scope. Individual endpoints may carry stricter, platform-only scope requirements, so check each endpoint's scope before integrating: the only projection available today, view=salesforce below, is platform-only and is NOT reachable with org:read (it requires the platform-reserved org:entitlements:read scope, which is not customer-requestable). Customer-facing endpoints that use org:read are forthcoming.

Entitlement verdict projections​

The view query parameter selects the projection of the entitlement verdict.

view=salesforce​

GET /v1/org/entitlements?view=salesforce returns the verdict shaped for the Salesforce connector. This projection is platform-only: the path is callable exclusively by Propper-generated Salesforce client applications, gated on the platform-reserved org:entitlements:read scope (with entitlements:read as its legacy alias). Neither is a customer-requestable scope, so customer-created applications cannot call it.