Create OAuth provider

Create a new OAuth provider configuration with encrypted client secret. The secret is never returned in API responses. Requires admin or owner role.

Authorization

User API Key

AuthorizationBearer <token>

User API key (mgw_usr_live_* or mgw_usr_test_*)

In: header

access_token?|

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

provider_type*string

Provider identifier (github, google, microsoft, okta)

Value in"github" | "google" | "entra" | "okta"

display_name*string

Human-readable name shown in the UI

Length1 <= length <= 100

client_id*string

OAuth client ID

Length1 <= length <= 255

client_secret*string

OAuth client secret (will be encrypted before storage)

Length1 <= length

is_enabled?boolean

Whether this provider is available for login

Defaulttrue

display_order?integer

Order in which to show providers in the UI

Default0

Range0 <= value

config?

Provider-specific configuration (e.g., tenant_id for Microsoft)

Response Body

`application/json`

curl -X POST "https://loading/api/v1/settings/auth/providers" \  -H "Content-Type: application/json" \  -d '{    "provider_type": "github",    "display_name": "string",    "client_id": "string",    "client_secret": "string"  }'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "provider_type": "string",
  "display_name": "string",
  "client_id": "string",
  "is_enabled": true,
  "display_order": 0,
  "config": {},
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Create OAuth provider

Authorization

Cookie Parameters

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`