Skip to main content
FuseFuse
IntegrationsOktaActions

Lookup Okta user by email

Find one Okta user by exact email or login.

Agent markdown

users.lookup_by_email · Okta · v1

Details

Risk
Read
Idempotency
Safe
Availability
Default
Exposure
REST, SDK, MCP
MCP hints
readOnly=true, destructive=false, idempotent=true, openWorld=true

Scopes

  • okta.users.read

Input

Input schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
emailstringYesminLength 3; maxLength 320

Output

Output schema
NameTypeRequiredConstraints
(root)objectYesadditionalProperties false
idstringYesminLength 1; maxLength 128
statusstringYesminLength 1; maxLength 64
transitioning_to_statusstringNominLength 1; maxLength 64
created_atstringNominLength 1; maxLength 64
activated_atstringNominLength 1; maxLength 64
last_login_atstringNominLength 1; maxLength 64
profileobjectYesadditionalProperties false
profile.loginstringYesminLength 1; maxLength 320
profile.emailstringYesminLength 3; maxLength 320
profile.first_namestringYesminLength 1; maxLength 256
profile.last_namestringYesminLength 1; maxLength 256
profile.display_namestringNominLength 1; maxLength 256
profile.titlestringNomaxLength 256
profile.departmentstringNomaxLength 256
profile.manager_idstringNominLength 1; maxLength 128
profile.employee_numberstringNomaxLength 128
profile.organizationstringNomaxLength 256
profile.cost_centerstringNomaxLength 128

Raw schema

Input
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "email": {
      "type": "string",
      "minLength": 3,
      "maxLength": 320
    }
  },
  "required": [
    "email"
  ]
}
Output
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "status": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "transitioning_to_status": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "created_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "activated_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "last_login_at": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "profile": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "login": {
          "type": "string",
          "minLength": 1,
          "maxLength": 320
        },
        "email": {
          "type": "string",
          "minLength": 3,
          "maxLength": 320
        },
        "first_name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256
        },
        "last_name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256
        },
        "display_name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 256
        },
        "title": {
          "type": "string",
          "maxLength": 256
        },
        "department": {
          "type": "string",
          "maxLength": 256
        },
        "manager_id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "employee_number": {
          "type": "string",
          "maxLength": 128
        },
        "organization": {
          "type": "string",
          "maxLength": 256
        },
        "cost_center": {
          "type": "string",
          "maxLength": 128
        }
      },
      "required": [
        "login",
        "email",
        "first_name",
        "last_name"
      ]
    }
  },
  "required": [
    "id",
    "status",
    "profile"
  ]
}