UptimeHunt Docs
Account

Login Methods

Manage multiple login methods including password, social sign-in (Google, GitHub), and organization SSO on one account.

Login Methods

Overview

A single UptimeHunt account can hold multiple login methods — a password, one or more social sign-ins (Google, GitHub), and one or more organization SSO identities. Every login method is an independent way to prove you are who you say you are; they all sign you into the same account.

Login methods are managed from Settings → Login & Email. The Security tab's Change Password form is a shortcut for updating an existing password (see Password Management).

Merging accounts vs. adding a login method

If you accidentally created two separate accounts (one with a password, one with Google), use the account merge flow to consolidate them. Adding a login method to an existing account is a different, lighter-weight operation — no merge required if you already have the right account open.

Login Method Types

KindWhat it isKey
passwordEmail-and-password sign-in.(email, password) — email is the account primary
social"Continue with Google" or "Continue with GitHub".Provider-stable account id — not the email
org_idpOIDC, SAML 2.0, Google Workspace, or GitHub provisioned by an organization's IdP.(IdP, sub / NameID)

Badges for each method are shown next to your name in organization member lists, so admins can distinguish accounts that share an email address across realms.

The ≥1 Login Method Invariant

The system never allows you to remove your last login method. Before removing any method, ensure you have at least one other verified method on the account. Attempts to remove the last method are rejected with 409 last_login_method.

Listing Your Login Methods

GET /api/v1/auth/me returns your login methods in identities[]:

{
  "data": {
    "identities": [
      {
        "kind": "password",
        "badge_label": "Password",
        "social_provider": null,
        "idp_label": null,
        "org_slug": null,
        "email": "alice@example.com",
        "verified": true,
        "is_primary": true,
        "added_at": "2025-01-10T09:00:00Z",
        "last_used_at": "2026-06-10T14:30:00Z"
      },
      {
        "kind": "social",
        "badge_label": "GitHub",
        "social_provider": "github",
        "idp_label": null,
        "org_slug": null,
        "email": "alice@github-noreply.example",
        "verified": true,
        "is_primary": false,
        "added_at": "2025-03-20T11:00:00Z",
        "last_used_at": "2026-05-01T08:00:00Z"
      }
    ]
  }
}

The identity with "is_primary": true is the one whose realm is used for legacy single-realm API fields; for new code, iterate identities[] directly.

Adding a Password Login Method

If your account was created via Google, GitHub, or an organization SSO sign-in, you may have no password. Adding one lets you sign in with an email and password in addition to your existing social/SSO methods — useful if you ever need a fallback or want to use tools that require password credentials.

curl -X POST https://app.uptimehunt.io/api/v1/auth/account/login-methods \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{"kind": "password", "password": "your-new-password"}'

Response (201 Created):

{ "data": { "identities": [ /* updated identity list */ ] } }

The password login method is keyed to your account's primary email. If you change your primary email later, the password login method's email claim is updated automatically.

Requirements:

  • Minimum 8 characters
  • Combination of character types recommended

On this page