Start flow with an identity provider
POST/v2/idp_intents
Start a flow with an identity provider, for external login, registration or linking..
Request​
- application/json
- application/grpc
- application/grpc-web+proto
Body
required
Possible values: non-empty
and <= 200 characters
ID for existing identity provider
urls
object
Possible values: non-empty
and <= 2048 characters
URL on which the user will be redirected after a successful login
Possible values: non-empty
and <= 2048 characters
URL on which the user will be redirected after a failed login
ldap
object
Possible values: non-empty
and <= 200 characters
Username used to login through LDAP
Possible values: non-empty
and <= 200 characters
Password used to login through LDAP
Body
required
Possible values: non-empty
and <= 200 characters
ID for existing identity provider
urls
object
Possible values: non-empty
and <= 2048 characters
URL on which the user will be redirected after a successful login
Possible values: non-empty
and <= 2048 characters
URL on which the user will be redirected after a failed login
ldap
object
Possible values: non-empty
and <= 200 characters
Username used to login through LDAP
Possible values: non-empty
and <= 200 characters
Password used to login through LDAP
Body
required
Possible values: non-empty
and <= 200 characters
ID for existing identity provider
urls
object
Possible values: non-empty
and <= 2048 characters
URL on which the user will be redirected after a successful login
Possible values: non-empty
and <= 2048 characters
URL on which the user will be redirected after a failed login
ldap
object
Possible values: non-empty
and <= 200 characters
Username used to login through LDAP
Possible values: non-empty
and <= 200 characters
Password used to login through LDAP
Responses​
- 200
- 403
- 404
- default
OK
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
URL to which the client should redirect
idpIntent
object
IDP Intent information
Possible values: non-empty
and <= 200 characters
ID of the IDP intent
Possible values: non-empty
and <= 200 characters
token of the IDP intent
Possible values: <= 200 characters
ID of the ZITADEL user if external user already linked
POST call information
{
"details": {
"sequence": "2",
"changeDate": "2024-12-20T16:04:44.045Z",
"resourceOwner": "69629023906488334"
},
"authUrl": "https://accounts.google.com/o/oauth2/v2/auth?client_id=clientID&callback=https%3A%2F%2Fzitadel.cloud%2Fidps%2Fcallback",
"idpIntent": {
"idpIntentId": "163840776835432705",
"idpIntentToken": "SJKL3ioIDpo342ioqw98fjp3sdf32wahb=",
"userId": "163840776835432345"
},
"postForm": "string"
}
- Schema
- Example (from schema)
Schema
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
URL to which the client should redirect
idpIntent
object
IDP Intent information
Possible values: non-empty
and <= 200 characters
ID of the IDP intent
Possible values: non-empty
and <= 200 characters
token of the IDP intent
Possible values: <= 200 characters
ID of the ZITADEL user if external user already linked
POST call information
{
"details": {
"sequence": "2",
"changeDate": "2024-12-20T16:04:44.045Z",
"resourceOwner": "69629023906488334"
},
"authUrl": "https://accounts.google.com/o/oauth2/v2/auth?client_id=clientID&callback=https%3A%2F%2Fzitadel.cloud%2Fidps%2Fcallback",
"idpIntent": {
"idpIntentId": "163840776835432705",
"idpIntentToken": "SJKL3ioIDpo342ioqw98fjp3sdf32wahb=",
"userId": "163840776835432345"
},
"postForm": "string"
}
- Schema
- Example (from schema)
Schema
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
URL to which the client should redirect
idpIntent
object
IDP Intent information
Possible values: non-empty
and <= 200 characters
ID of the IDP intent
Possible values: non-empty
and <= 200 characters
token of the IDP intent
Possible values: <= 200 characters
ID of the ZITADEL user if external user already linked
POST call information
{
"details": {
"sequence": "2",
"changeDate": "2024-12-20T16:04:44.046Z",
"resourceOwner": "69629023906488334"
},
"authUrl": "https://accounts.google.com/o/oauth2/v2/auth?client_id=clientID&callback=https%3A%2F%2Fzitadel.cloud%2Fidps%2Fcallback",
"idpIntent": {
"idpIntentId": "163840776835432705",
"idpIntentToken": "SJKL3ioIDpo342ioqw98fjp3sdf32wahb=",
"userId": "163840776835432345"
},
"postForm": "string"
}
Returned when the user does not have permission to access the resource.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Returned when the resource does not exist.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}