Sign in
latestOpenAPI 3.1.02026-08-22154287463.4 KB

858365328f92

Managed Auth

Submit field values

Submits field values for the login form. Poll the auth connection to track progress and get results.

post/auth/connections/{id}/submit

Path parameters

idstring required

Auth connection ID

Request body

field_valuesobject

Canonical map of field ID to submitted value.

fieldsobject

Map of field name to value

interaction_idstring

Opaque interaction ID returned with canonical fields and choices. Required for canonical submissions.

mfa_option_idstring

The MFA method type to select (when mfa_options were returned)

selected_choice_idstring

Canonical choice ID selected by the user.

sign_in_option_idstring

The sign-in option ID to select (when sign_in_options were returned)

sso_button_selectorstring

XPath selector for the SSO button to click (ODA). Use sso_provider instead for CUA.

sso_providerstring

SSO provider to click, matching the provider field from pending_sso_buttons (e.g., "google", "github"). Cannot be used with sso_button_selector.

Example request

{
  "field_values": {
    "field_email": "user@example.com",
    "field_password": "secret"
  },
  "fields": {
    "email": "user@example.com",
    "password": "secret"
  },
  "interaction_id": "mai_abc123xyz",
  "mfa_option_id": "sms",
  "selected_choice_id": "google",
  "sign_in_option_id": "work-account",
  "sso_button_selector": "xpath=//button[contains(text(), 'Continue with Google')]",
  "sso_provider": "google"
}

Response

Submission accepted for processing

acceptedboolean required

Whether the submission was accepted for processing