POST
/
api
/
v1
/
auth
/
register
Registers a user.
curl --request POST \
  --url https://sdp.suki-stage.com/api/v1/auth/register \
  --header 'Content-Type: application/json' \
  --data '{
  "partner_id": "your-partner-id",
  "partner_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "provider_id": "provider-123",
  "provider_name": "Dr. John Smith",
  "provider_org_id": "org-123",
  "provider_specialty": "CARDIOLOGY"
}'
This response has no body data.
Use this endpoint to register a new healthcare provider in the Suki platform or to link an existing provider to a new partner-organization relationship. This is a one-time setup call for each provider within an organization.

​
Registration Scenarios

This endpoint handles three different scenarios depending on the user’s status in the Suki system.
ScenarioConditionActions TakenResponse
New UserThe provider does not exist in Suki.• Creates a new organization
• Links your partner account to the organization
• Creates a new user with the provided details		201 Created
Existing User, New LinkThe provider exists but is not yet linked to your partner account.• Verifies the user and organization details
• Links your partner account to the existing organization		201 Created
Existing User, Already LinkedThe provider and organization are already linked to your partner account.• Detects the existing link409 Conflict

Body

application/json

RegistrationRequest

Request body for the /auth/register endpoint