> For the complete documentation index, see [llms.txt](https://help.sipgate.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sipgate.de/cloud-telefonanlage/en/connections-and-integrations/integrationen-fur-die-sipgate-app/nextcloud-integration.md).

# Nextcloud integration

Nextcloud makes it possible to manage your data on your own cloud server without having to hand over control of the data to companies like Google or Apple. With a mix of self-hosting and private cloud computing, Nextcloud therefore offers individual, better data protection than commercial US cloud providers.

With sipgate, you can make calls directly from Nextcloud and use your contacts in the sipgate app. This way, you can always see which contact is calling and do not have to switch between different tools. sipgate is your phone system with the telephony app for desktop and mobile.

#### **Integration of Nextcloud in the sipgate app**

{% stepper %}
{% step %}
**Select integration**

In the sipgate app, click the gear icon on the left and select the "Integrations" item.

Under the "Integrations" section, search for the "Nextcloud" entry and click the "Connect with Nextcloud" button. ![nextcloud.png](/files/154efc06f5cf0e66bf884eabafa1e8fbe427959e)
{% endstep %}

{% step %}
**Enter API data**

Enter the required API key and API URL here.

{% hint style="warning" %}
**Important: The API key must be entered in the form "Username:Webtoken".**
{% endhint %}

Copy the API URL from the address field in the browser window of your Nextcloud instance.

![nextcloud\_api.png](/files/9a0b94f351e6c85c05f0aeb4305104215117e3cb)
{% endstep %}

{% step %}
**Confirm connection**

You have successfully connected Nextcloud and the sipgate app.

{% hint style="info" %}
Note: Depending on the number of contacts to be integrated, it may take a few minutes until they are fully displayed.
{% endhint %}
{% endstep %}
{% endstepper %}

#### **Find or create API key in your Nextcloud account**

Click on your user icon in the top right of your Nextcloud instance and then open the "Administration settings" menu item.

![nextcloud1 Copy.png](/files/0db96b2cf2bccbf7dc047cf0220df4ff3373eca3)

Now select "Security" on the left under the heading "Personal".

![nextcloud2 Copy.png](/files/6cc253bfe32bf39f356f22ce9d64dc6179121e52)

#### **Errors and solutions:**

<details>

<summary>Error: “Invalid credentials” with self-hosted Nextcloud</summary>

**self-hosted Nextcloud**

Most likely, the sipgate app will not be able to connect successfully and will report the error: “Invalid credentials”.\
**Cause**: on the self-set-up web server/load balancer/etc., requests are not forwarded to Nextcloud via WebDAV\
**Information**:

WebDAV:

Here you can create the required web token (API key). If you have already created web tokens in the past, they can be deleted, revoked, or renamed here. Please note that the actual tokens (API keys) can only be viewed and copied once during creation.

Scroll to the bottom of the page, enter any name in the “App name” field, and then click the “Create new app password” button.

![nextcloud3 Copy.png](/files/edf981df7fc63f9695695fc552a28a294cdd008b)

Please note the displayed instructions and copy the newly created token. Finally, click the “Done” button. ![nextcloud4 Kopie.png](/files/cf0cf4356769f446347598906b1354b03175cc2e)

</details>


---

# 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://help.sipgate.de/cloud-telefonanlage/en/connections-and-integrations/integrationen-fur-die-sipgate-app/nextcloud-integration.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.
