Start flow with an identity provider​
Start a flow with an identity provider, for external login, registration or linking
Request Body required
Possible values: non-empty and <= 200 characters
ID for existing identity provider
urls object
Possible values: non-empty and <= 200 characters
URL on which the user will be redirected after a successful login
Possible values: non-empty and <= 200 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
Request Body required
Possible values: non-empty and <= 200 characters
ID for existing identity provider
urls object
Possible values: non-empty and <= 200 characters
URL on which the user will be redirected after a successful login
Possible values: non-empty and <= 200 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
Request Body required
Possible values: non-empty and <= 200 characters
ID for existing identity provider
urls object
Possible values: non-empty and <= 200 characters
URL on which the user will be redirected after a successful login
Possible values: non-empty and <= 200 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
- 200
 - 403
 - 404
 - default
 
OK
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-05-10T13:32:02.644Z",
    "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
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-05-10T13:32:02.645Z",
    "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
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-05-10T13:32:02.645Z",
    "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.
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
Returned when the resource does not exist.
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
An unexpected error response.
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}
Schema
- Array [
 - ]
 
details object[]
{
  "code": 0,
  "message": "string",
  "details": [
    {
      "@type": "string"
    }
  ]
}