Saml

Configure a saml connection

Used to configure the saml connection for a company.

Core configuration changes (issuer_uri, login_urls) require the allow_core_config_update flag to be set to true. This protects against accidental misconfiguration. Certificate updates (x509cert, xml_metadata), domains, and active status changes are considered maintenance operations and do not require this flag.

post/saml/{id}

Request

  • Base URL: https://api.mabl.com
  • URL: https://api.mabl.com/saml/{id}
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

idstring required

Id of the saml connection to configure

Query parameters

rebuild_provider_configboolean

Set to true to allow core configuration changes (issuer_uri, login_url, domains) and regenerate identity provider field mappings from the metadata. Without this flag, only maintenance operations like certificate updates and active status changes are allowed.

Request body

idstring

The id of the connection

company_idstring

the mabl company id this connection is associated with

domainsstring[]

Array of domains to associate with this connection (domain lock)

activeboolean required

true if the connection is active/live

Response

The setup connection

idstring

The id of the connection

company_idstring

the mabl company id this connection is associated with

domainsstring[]

Array of domains to associate with this connection (domain lock)

activeboolean required

true if the connection is active/live

Changes

No recorded changes to this operation across all 37 revisions of this API.