Skip to content
Management API Reference

Creates a new SSO provider

post/v1/projects/{ref}/config/auth/sso/providers

OAuth scopes

  • auth:write

The fine-grained token must include the following permissions to access this endpoint:

  • auth_config_write

Path parameters

  • ref
    Required
    string

    Project ref

Body

  • type
    Required
    enum
  • metadata_xml
    Optional
    string
  • metadata_url
    Optional
    string
  • domains
    Optional
    Array<string>
  • attribute_mapping
    Optional
    object
  • name_id_format
    Optional
    enum

Response codes

  • 201
  • 401
  • 403
  • 404
  • 429

Response (201)

{
"id": "lorem",
"saml": {
"entity_id": "lorem",
"metadata_url": "lorem",
"metadata_xml": "lorem",
"attribute_mapping": {
"keys": {
"property1": {
"name": "lorem",
"names": [
"lorem"
],
"default": {},
"array": true
},
"property2": {
"name": "lorem",
"names": [
"lorem"
],
"default": {},
"array": true
}
}
},
"name_id_format": "urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified"
},
"domains": [
{
"domain": "lorem",
"created_at": "lorem",
"updated_at": "lorem"
}
],
"created_at": "lorem",
"updated_at": "lorem"
}