Register Provider Then Login

Problem: Login returns 401 with provider_not_registered for a new provider. Solution: Call Register once (201 or 409 both OK for this flow), then call Login again and use the returned suki_token as sdp_suki_token.

This cookbook assumes you already have your Partner ID and Partner Token. For Bearer partners, also send provider_id on register and login.

TypeScript
Python

async function login(partnerId: string, partnerToken: string, providerId?: string) {
  const body: Record<string, string> = {
    partner_id: partnerId,
    partner_token: partnerToken,
  };
  if (providerId) body.provider_id = providerId;

  const res = await fetch("https://sdp.suki.ai/api/v1/auth/login", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
  const data = await res.json().catch(() => ({}));
  if (!res.ok) {
    throw new Error(String(data.message || res.status));
  }
  return data.suki_token as string;
}

async function registerProvider(input: {
  partnerId: string;
  partnerToken: string;
  providerName: string;
  providerOrgId: string;
  providerId?: string;
}) {
  const body: Record<string, string> = {
    partner_id: input.partnerId,
    partner_token: input.partnerToken,
    provider_name: input.providerName,
    provider_org_id: input.providerOrgId,
  };
  if (input.providerId) body.provider_id = input.providerId;

  const res = await fetch("https://sdp.suki.ai/api/v1/auth/register", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(body),
  });
  // New link: 201. Already linked: 409. Both are success for this flow.
  if (res.status !== 201 && res.status !== 409) {
    throw new Error(`Register failed: ${res.status}`);
  }
}

async function loginWithRegisterFallback(
  partnerId: string,
  partnerToken: string,
  providerId: string | undefined,
  providerName: string,
  providerOrgId: string
) {
  try {
    return await login(partnerId, partnerToken, providerId);
  } catch (err) {
    if (!String(err).includes("provider_not_registered")) throw err;
    await registerProvider({
      partnerId,
      partnerToken,
      providerName,
      providerOrgId,
      providerId,
    });
    return login(partnerId, partnerToken, providerId);
  }
}

const sukiToken = await loginWithRegisterFallback(
  partnerId,
  partnerToken,
  providerId,
  "Dr. Jane Smith",
  "org-123"
);

from typing import Optional

import requests

def login(partner_id: str, partner_token: str, provider_id: Optional[str] = None) -> str:
    payload = {"partner_id": partner_id, "partner_token": partner_token}
    if provider_id:
        payload["provider_id"] = provider_id
    r = requests.post(
        "https://sdp.suki.ai/api/v1/auth/login",
        headers={"Content-Type": "application/json"},
        json=payload,
    )
    if not r.ok:
        raise RuntimeError(r.json().get("message", r.text))
    return r.json()["suki_token"]

def register_provider(
    partner_id: str,
    partner_token: str,
    provider_name: str,
    provider_org_id: str,
    provider_id: Optional[str] = None,
) -> None:
    payload = {
        "partner_id": partner_id,
        "partner_token": partner_token,
        "provider_name": provider_name,
        "provider_org_id": provider_org_id,
    }
    if provider_id:
        payload["provider_id"] = provider_id
    r = requests.post(
        "https://sdp.suki.ai/api/v1/auth/register",
        headers={"Content-Type": "application/json"},
        json=payload,
    )
    # New link: 201. Already linked: 409. Both are success for this flow.
    if r.status_code not in (201, 409):
        r.raise_for_status()

def login_with_register_fallback(
    partner_id: str,
    partner_token: str,
    provider_id: Optional[str],
    provider_name: str,
    provider_org_id: str,
) -> str:
    try:
        return login(partner_id, partner_token, provider_id)
    except RuntimeError as err:
        if "provider_not_registered" not in str(err):
            raise
        register_provider(
            partner_id, partner_token, provider_name, provider_org_id, provider_id
        )
        return login(partner_id, partner_token, provider_id)

suki_token = login_with_register_fallback(
    partner_id,
    partner_token,
    provider_id,
    "Dr. Jane Smith",
    "org-123",
)

Common mistakes

Treat register 409 as failure. For this flow, the provider is already linked.
Forget Bearer provider_id on both register and login when you are a Bearer partner.

Other cookbooks

AuthenticationAPI

Send provider_id on Bearer login.

5 min

AmbientAPI

Create session with emr_encounter_id.

5 min

​Common mistakes

​Other cookbooks

​Add provider_id to Bearer Login

​Share One Note Across Products

Common mistakes

Other cookbooks

Add provider_id to Bearer Login

Share One Note Across Products