Create incoming referral

Creates a new incoming referral.

Note: This endpoint requires a user-scoped OAuth token. A pure client_credentials token without user context will be rejected. The treating user is automatically derived from the token and cannot be set manually.

Request

POST /api/oauth/v2/resource/incoming-referrals

Header

Header	Value
Authorization	Bearer {access_token}
Content-Type	application/json

Body parameters

Field	Type	Required	Description
customerUuid	string	Yes	UUID of the assigned customer (must belong to the same company)
services	array	No	List of referred services
diagnose	string	No	Diagnosis for the referral
date	string	No	Referral date (YYYY-MM-DD, default: today)

Response

Success (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "services": ["Physiotherapy", "Ultrasound"],
    "diagnose": "M54.5",
    "date": "2026-06-09",
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    },
    "practitioner": {
      "name": "Dr. Thomas Berger"
    }
  }
}

Response fields

See Get incoming referral for the full field description.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/incoming-referrals" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "services": "beispiel",
    "diagnose": "beispiel",
    "date": "2026-04-15T10:00:00"
  }'

Server

Client-ID

Client-Secret

Parameter

customerUuid *string

services array

diagnose string

date string

Zuerst Token anfordern

Possible errors

Status	Code	Description
400	validation_error	Invalid request data (e.g. customerUuid missing)
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope medicals not present
404	not_found	Customer not found