/admin/identity-providersCreate a new identity provider (OAuth/OIDC/SAML/Social)
Schema: dto.CreateIDPRequest
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
client_id |
string |
Yes | client_123 |
Client ID | |
client_secret |
string |
Yes | secret_456 |
Client Secret | |
name |
string |
Yes | My OIDC Provider |
Display name | |
type |
string |
Yes | custom |
Type | |
attribute_mapping |
object |
No | extra keys: `string` | Field mapping | |
auth_url |
string |
No | https://example.com/auth |
Authorization endpoint | |
config |
object |
No | Extra configuration | ||
display_name |
string |
No | My OIDC Provider |
Frontend display name | |
icon_url |
string |
No | https://example.com/icon.png |
Icon URL | |
scopes |
array of string |
No | ['[openid', 'profile', 'email]'] |
Scope | |
sort_order |
integer |
No | 0 |
Sort order | |
token_url |
string |
No | https://example.com/token |
Token endpoint | |
user_info_url |
string |
No | https://example.com/userinfo |
User info endpoint |
| Status | Description | Schema |
|---|---|---|
| 200 | OK | dto.IDPDetailResponse |
| 400 | Bad Request | dto.SimpleResponseWrapper |
| 401 | Unauthorized | dto.SimpleResponseWrapper |
| 500 | Internal Server Error | dto.SimpleResponseWrapper |
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
data |
dto.IDPResponse |
No | |||
message |
string |
No | |||
timestamp |
string |
No |
Identity provider details
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
attribute_mapping |
object |
No | extra keys: `string` | Field mapping | |
auth_url |
string |
No | https://example.com/auth |
Authorization endpoint | |
client_id |
string |
No | client_123 |
Client ID | |
config |
object |
No | Extra configuration | ||
created_at |
string |
No | 2026-01-01T00:00:00Z |
Created at | |
display_name |
string |
No | My OIDC Provider |
Frontend display name | |
icon_url |
string |
No | https://example.com/icon.png |
Icon URL | |
id |
string |
No | idp_abc123 |
Provider ID | |
is_popular |
boolean |
No | False |
Common provider | |
is_system |
boolean |
No | False |
System built-in | |
name |
string |
No | My OIDC Provider |
Display name | |
scopes |
array of string |
No | ['[openid', 'profile', 'email]'] |
Scope | |
sort_order |
integer |
No | 0 |
Sort order | |
status |
string |
No | active |
Status | |
tenant_id |
string |
No | tnt_xyz789 |
Tenant ID | |
token_url |
string |
No | https://example.com/token |
Token endpoint | |
type |
string |
No | custom |
Type | |
type_display_name |
string |
No | Custom |
Type display name | |
updated_at |
string |
No | 2026-04-10T14:20:00Z |
Updated at | |
user_info_url |
string |
No | https://example.com/userinfo |
User info endpoint |
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
message |
string |
No |