Skip to content

Integrate a Service with Langdock

This article shows how to integrate a Xtract Universal.iQ service with Langdock workflows using HTTPS request nodes. For information on how to integrate Xtract Universal.iQ services using the Xtract Universal.iQ MCP server, see Xtract Universal.iQ MCP Integration with Langdock.

Setup in Xtract Universal.iQ

Before integrating Xtract Universal.iQ with third-party tools:

  1. Create a service in Xtract Universal.iQ.
  2. Testrun the service in Xtract Universal.iQ to make sure it works, see Documentation: Run Services in Xtract Universal.iQ.
  3. Click [ Run > Service > Copy URL] to copy the service URL to your clipboard.

You can now use the endpoint URL to run services in Langdock workflows.

Setup in Langdock

To run Xtract Universal.iQ services from Langdock workflows:

  1. Open https://app.langdock.com/ and create a new workflow in the Workflows section.
  2. Add a trigger node and an HTTP Request node.
    langdock-add-http-request.gif
  3. In the HTTP Request node settings, set Method to POST.

  4. Enter the Xtract Universal.iQ service endpoint URL into URL, e.g., https://sap-link.example.com:8175/services/[service-name].

    Tip

    You can find the URL in the Run menu of your service.

  5. Add headers that define authentication and input / output formats of the service. Examples:

    Key Value Description
    Authorization Basic [base64 encoded username:password] Authentication against Xtract Universal.iQ. If Xtract Universal.iQ uses access restrictions, enter Basic followed by your base64 encoded Xtract Universal.iQ credentials in the format username:password.
    Content-Type application/json Specifies that the data you send in the request body is formatted as JSON. Use this when passing parameters as a JSON object.
    Accept application/json Specifies that you want to receive the response data in JSON format.

  6. Optional: use Send Body or Send Query Parameters to pass parameters to your service, see Pass Parameters.

  7. Click [] at the top of the node to test the service call. If successful, the Output panel underneath the node displays the service output.
    simple workflow that highlights the run button in the HTTP request node and shows the service output

You can now fetch SAP data via Xtract Universal.iQ and pass it to other nodes for further processing.

Pass Parameters

There are multiple ways to pass parameters to your service in Langdock:

Configure Body Using JSON

To pass parameters in the request body of the service:

  1. Open the Xtract Universal.iQ Services menu.
  2. Select the service you want to parameterize and click Run > Service > Run. The "Run" menu opens.
  3. Optional: Enter values using the Input Parameters fields.
  4. In the Parameters section, click Save. The parameters are downloaded as a [service name]_input_payload.json file to your machine. The file contains all parameters and their structure in JSON format. If you assign parameters in the "Run" menu before downloading the payload, they are included in the file.
  5. Open the HTTP Request node settings in your Langdock workflow.

  6. Add the following header:

    Key Value
    Content-Type application/json

  7. Copy the content of the [service-name]_input_payload.json file into the Request Body field.

  8. If your parameters do not have values yet, add values directly in the JSON body or use Langdock variables to map parameters to output from previous nodes, see Langdock Documentation: Variable Usage.
    langdock-body-parameters-payload
  9. Click [] at the top of the node to test the service call. If successful, the Output panel underneath the node displays the service output.

You can now pass parameters to your service and fetch specific data from SAP.

For information on how to pass variables, refer to Langdock Documentation: Variable Usage.

Last update: June 30, 2026
Written by: Christian Tauchmann, Valerie Schipka