> For the complete documentation index, see [llms.txt](https://docs-v3.toucantoco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](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).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` 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>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.