Test integration connections

Verify that a configured integration can connect to its external endpoint before saving.

Before you begin

  • You must have an administrator role in the automation orchestrator.
  • You must have completed the integration details on the Configure integration wizard or opened an existing integration with Edit integration.

Procedure

  1. On the integration configuration form, complete all required fields.
  2. Click Test connection.

    The system attempts to connect to the configured endpoint using the provided health check credential. The test must complete within the configured timeout (10 seconds by default). LLM Provider and MCP Server integrations also discover available resources during the connection test.

  3. Review the test result.
    • Success: A confirmation message indicates that the endpoint is reachable. You can proceed to save the integration.
    • Failure: An error message describes the issue. Common causes include:
      Symptom Possible cause Action
      Connection timed out The API URL is incorrect or the server is unreachable from the Orchestrator network. Verify the API URL and check network connectivity.
      Authentication failed The health check credential is invalid. Verify your health check credential and re-enter it.
      SSL/TLS error The endpoint uses a certificate that the Orchestrator does not trust. Verify the endpoint certificate configuration.
  4. After resolving any issues, click Test connection again to confirm.
  5. Click Save to save the integration.

Results

The integration connection is verified and saved with a confirmed connection to the external endpoint.