Initiates an external authentication using the given authentication container.


The service initiates an external authentication with the given external authentication vendor. The authentication container and its content will be verified before an attempt is made to initiate an external authentication. SoftLayer_Container_User_Customer_External_Binding_Phone container can be used for this service.

This service returns a unique authentication request token. You can use SoftLayer_User_Customer::checkExternalAuthenticationStatus service to check if the authentication request is complete or not.


Name Type Description
authenticationContainer SoftLayer_Container_User_Customer_External_Binding The authentication container with the external authentication information.

Required Headers

  • authenticate

Return Values

  • string

Error Handling

  • SoftLayer_Exception_Public

Throw the error “Invalid external authentication container is provided.” when you have provide an invalid authentication container.

  • SoftLayer_Exception_Public

Throw the error “Invalid login credentials provided.” when you have provide incorrect authentication information.