# Setting up a SOAP Connector

### SOAP Connector¶

This Connector is a generic connector to query SOAP APIs. It requires an URL to the Service definition file (WSDL file) to load the available services and can handle various authentication protocol, provided that credentials can be passed through a header.

#### Data Provider’s configuration¶

<figure><img src="/files/9xdIkJZPOzWOrX5ptX3Y" alt="Add a connector"><figcaption><p>Add a connector</p></figcaption></figure>

* Look up for SOAP in connector’s list

<figure><img src="/files/iwFuBh81cCO42vcl9uS6" alt="soap_logo"><figcaption><p>soap_logo</p></figcaption></figure>

You can now configure the **Data Provider** :

* Fill the name `field` with a relevant name
* `Headers` is an optional dict with authentication information e.g `{"Authorization": "Bearer 1234567"}`
* `Wsdl Endpoint` is a mandatory URL pointing to the *SOAP* service definition file (WSDL File) e.g: `https://example.com/services/service1?wsdl`

<figure><img src="/files/FAS96xzWDMSdu8aHXdiL" alt="soap_connector_form"><figcaption><p>soap_connector_form</p></figcaption></figure>

Finally, you can configure the **Data Source**

* Fill the domain `field` with a relevant name
* Select a `Method` from the dropdown list. It will be auto filled if the connection to the WSDL file is effective
* Give the required parameters in the `Service Parameters` field as a dict. To help you, the tooltip (? above the field) is populated with the services definitions.
* Optionally, fill the `Flatten Column` field with a list of column names where the data is nested (i.e the column is a dict)

<figure><img src="/files/1hHQzWfrDu68P8cZfdSu" alt="soap_ds"><figcaption><p>soap_ds</p></figcaption></figure>

Below is an example of Tooltip

<figure><img src="/files/suOgMYnlBRGGd09cJpLS" alt="tooltip_soap"><figcaption><p>tooltip_soap</p></figcaption></figure>

Your **SOAP** Connector is now configured 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-v3.toucantoco.com/data-management-in-datahub/datasources-in-toucan/managing-connectors/setting-up-a-connector/generic-connectors/setting-up-a-soap-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.