Connect a customer's app (OAuth)

detail = client.applications.get("outlook")
method = next(m for m in detail.authentication_methods if m.requires_o_auth_sign_in)

const detail = await client.applications.get("outlook");
const method = detail.authenticationMethods.find((m) => m.requiresOAuthSignIn)!;

curl -s "$BASE/applications/outlook" -H "$AUTH" \
  | jq '.authenticationMethods[] | select(.requiresOAuthSignIn) | {authenticationId, authenticationName}'

resp = client.connections.get_sign_in_url("outlook", method.authentication_id)
sign_in_url, state = resp.sign_in_url, resp.state

const { signInUrl, state } = await client.connections.getSignInUrl("outlook", method.authenticationId);

curl -s -X POST "$BASE/connections/get-sign-in-url" -H "$AUTH" -H "Content-Type: application/json" -d '{
  "applicationSlug": "outlook",
  "authenticationId": 0
}'
# -> { "signInUrl": "https://login.microsoftonline.com/...", "state": "3f2a..." }

import time

deadline = time.time() + 300
while time.time() < deadline:
    token = client.connections.get_access_token(state)
    status = ((token and token.status) or "").lower()
    if status in {"completed", "complete", "success", "succeeded"}:
        break
    if status in {"failed", "error", "cancelled", "canceled", "denied"}:
        raise RuntimeError(token.error_message or "The user did not complete sign-in.")
    time.sleep(2)
else:
    raise TimeoutError("Sign-in was not completed in time.")

const deadline = Date.now() + 300_000;
let token;
for (;;) {
  token = await client.connections.getAccessToken(state);
  const status = (token?.status ?? "").toLowerCase();
  if (["completed", "complete", "success", "succeeded"].includes(status)) break;
  if (["failed", "error", "cancelled", "canceled", "denied"].includes(status))
    throw new Error(token?.error_message ?? "The user did not complete sign-in.");
  if (Date.now() > deadline) throw new Error("Sign-in was not completed in time.");
  await new Promise((r) => setTimeout(r, 2000));
}

# poll every 2s; an empty body means "still waiting"
until curl -s "$BASE/connections/access-token/$STATE" -H "$AUTH" | jq -e '.status' >/dev/null 2>&1; do
  sleep 2
done
curl -s "$BASE/connections/access-token/$STATE" -H "$AUTH" | jq '{status, connectionData}'

props = token.connection_data.additional_properties or {}
fields = {k: v if isinstance(v, str) else str(v) for k, v in props.items() if v is not None}

created = client.connections.create("outlook", "Alex's Outlook", method.authentication_id, fields)
client.connections.set_default(created.connection_id)   # optional but recommended

const fields = Object.fromEntries(
  Object.entries(token.connectionData)
    .filter(([, v]) => v != null)
    .map(([k, v]) => [k, typeof v === "string" ? v : String(v)]),
);

const created = await client.connections.create("outlook", "Alex's Outlook", method.authenticationId, fields);
await client.connections.setDefault(created.connectionId);   // optional but recommended

curl -s -X POST "$BASE/connections" -H "$AUTH" -H "Content-Type: application/json" -d '{
  "applicationSlug": "outlook",
  "connectionName": "Alex'\''s Outlook",
  "authenticationId": 0,
  "fields": { "...": "values from connectionData" }
}'