Sign in

v1

latestOpenAPI 3.0.12026-07-2649123153.6 KB
/api/v1/auth

Register provider

Registers a new provider in Suki or links an existing provider to your partner organization. This is a one-time setup call per provider.

post/api/v1/auth/register

Request body

partner_idstring required

Unique identifier for the partner. This will be shared securely by Suki to the partner through a separate partner registration process.

partner_tokenstring required

JWT token issued by trusted authorization server. The token must include Provider Email.

provider_idstring

Optional for standard partners.

Required for:

  • Bearer authentication. Send provider_id so Suki can identify the provider during Login or Register.
  • Single Auth Token authentication. Send provider_id so Suki can identify the clinician during Login or Register.
provider_namestring required

Name of the provider.

provider_org_idstring required

Health system or organization to which the provider belongs.

provider_specialtystring

Optional - Medical specialty of the provider. Defaults to FAMILY_MEDICINE if not provided.

Example request

{
  "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"
}

Response

Resource created successfully.