Connect a customer's app (OAuth)

detail = client.applications.get("outlook")
method = next(
    (m for m in detail.authentication_methods if m.is_default),
    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.isDefault) ??
  detail.authenticationMethods.find((m) => m.requiresOAuthSignIn)!;

curl -s "$BASE/applications/outlook" -H "$AUTH" \
  | jq '.authenticationMethods[] | {authenticationId, authenticationName, isDefault, description, helpUrl}'
# pick the entry with isDefault: true, or requiresOAuthSignIn: true if none is flagged

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}'

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

const created = await client.connections.create(
  "outlook", "Alex's Outlook", method.authenticationId, {}, { oauthState: state },
);
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,
  "oauthState": "'"$STATE"'",
  "fields": {}
}'