Skip to main content
POST
Create an outbound referral

Authorizations

x-api-key
string
header
required

Org-issued integration API key (service account credential). The plaintext secret is shown once at creation.

Headers

X-Idempotency-Key
string
required

Stable caller-chosen key (max 200 chars) making the mutation safely retryable.

Maximum string length: 200

Path Parameters

caseId
string
required

Case id

Body

application/json
targetOrganizationId
string
Required string length: 1 - 200
external
object
feeSharingPercentage
integer
Required range: 0 <= x <= 100
reason
enum<string>
Available options:
conflict_of_interest,
outside_jurisdiction,
insufficient_resources,
specialization_mismatch,
overbooked,
other
notes
string
Maximum string length: 5000

Response

{ success: true, referral }

success
boolean
required
{key}
any