> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your app to Sevdesk

> Connect your app to Sevdesk, an accounting and invoicing platform, to manage contacts, invoices, orders, vouchers, and bookkeeping workflows from your Lovable app.

export const connector_0 = "Sevdesk"

[Sevdesk](https://www.sevdesk.de/) is an accounting and invoicing platform for managing business contacts, invoices, orders, vouchers, payments, and bookkeeping workflows. The Sevdesk connector lets your Lovable app call the Sevdesk API through a connected Sevdesk account.

With Sevdesk, your app can:

* List and manage customers, suppliers, and contact addresses
* Create and retrieve invoices, orders, vouchers, and credit notes
* Build bookkeeping workflows around payments and account data
* Query accounting resources such as countries, tax rules, and categories

Sevdesk is a good fit when your app needs operational accounting data, finance workflows, or back-office tools connected to a Sevdesk account.

## Common use cases and example apps

| Example app                      | Example prompt                                                                                                   | Description                                                                                                                                                                  |
| :------------------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Invoice dashboard**            | *Use Sevdesk and build an invoice dashboard that lists open invoices, due dates, customers, and payment status.* | **Track invoice work from one internal view.**<br />The app fetches invoice and contact data from Sevdesk so finance teams can review outstanding work.                      |
| **Customer accounting portal**   | *Use Sevdesk and build a customer portal that shows invoices, orders, and credit notes for each customer.*       | **Give customers access to accounting documents.**<br />The app retrieves the right records from Sevdesk and presents them in a branded portal.                              |
| **Contact management tool**      | *Use Sevdesk and build an internal tool for searching customers, suppliers, and contact addresses.*              | **Keep accounting contacts accessible.**<br />The app reads Sevdesk contacts, including person contacts, and gives teams a focused interface for customer and supplier data. |
| **Voucher review workflow**      | *Use Sevdesk and build a voucher review workflow for incoming expenses and receipts.*                            | **Move expense review into a guided app.**<br />The app creates or retrieves voucher records in Sevdesk and helps operators review missing details.                          |
| **Order tracking app**           | *Use Sevdesk and build an order tracking app that shows active orders and related customer records.*             | **Monitor orders before they become invoices.**<br />The app retrieves orders and related contacts from Sevdesk for sales and finance follow-up.                             |
| **Bookkeeping resource browser** | *Use Sevdesk and build an admin page that lists tax rules, countries, categories, and check accounts.*           | **Surface reference data for finance workflows.**<br />The app reads Sevdesk accounting resources so operators can use consistent values in internal workflows.              |

## How to connect Sevdesk

Workspace **admins** and **owners** can connect Sevdesk.

You can create multiple Sevdesk connections using different API tokens, which is useful for connecting different Sevdesk accounts or users.

When the connection is created, Sevdesk becomes available across all projects in the workspace. Anyone building in a project can ask Lovable in chat to link their project to it.

### Prerequisites

Before connecting Sevdesk, make sure you have:

* A Sevdesk account with API access
* A Sevdesk API token
* Lovable workspace owner or admin role

<Note>
  All API requests made through this connector use your Sevdesk API token. API usage, plan limits, and billing are handled directly by Sevdesk, not Lovable.
</Note>

### Step 1: Get a Sevdesk API token

A Sevdesk API token lets your Lovable app authenticate with the Sevdesk API.

To find your Sevdesk API token:

<Steps>
  <Step title="Open your Sevdesk account">
    Sign in to [Sevdesk](https://my.sevdesk.de/) with the account you want to connect.
  </Step>

  <Step title="Open your user settings">
    Go to **Settings → Users**, then open the user whose API access you want to use.
  </Step>

  <Step title="Copy the API token">
    Find the **API token** field and copy the 32-character token.
  </Step>
</Steps>

<Warning>
  Your API token functions like a password. Keep it secure and never share it publicly. You need it in the next step.
</Warning>

See Sevdesk documentation for more: [Sevdesk API documentation](https://api.sevdesk.de/).

### Step 2: Connect Sevdesk to Lovable

You can create multiple connections using different API tokens.

<Steps>
  <Step title="Open Sevdesk in Connectors">
    Go to **Connectors → App connectors** and select **Sevdesk**.
  </Step>

  <Step title="Add a connection">
    Click **Add connection**.
  </Step>

  <Step title="Configure the connection">
    1. **Display name**: name the connection, for example `Sevdesk Prod`.
    2. **API token**: paste your 32-character Sevdesk API token.
  </Step>

  <Step title="Choose who can access this connection">
    Under **Who can access this connection**, decide who in your workspace can use the connection:

    * **Only you** (default): only the person creating the connection can use it and its associated data.
    * **Invite specific people**: only you and explicitly added workspace members can use the connection and its associated data.
    * **Invite entire workspace**: click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

    See [Connection-level access](/integrations/introduction#connection-level-access) for more information.
  </Step>

  <Step title="Connect">
    Click **Connect**.
  </Step>
</Steps>

When connected, anyone building in a project can ask Lovable in chat to link their project to Sevdesk (based on configured connection-level access). Your Lovable apps can then work with Sevdesk accounting, contact, invoice, order, voucher, and payment data.

## Working with contacts

Sevdesk's contact API separates organizations from person contacts. When you ask Lovable to list contacts, include person contacts if you want customers, suppliers, and individual contacts to appear.

For example, ask Lovable:

```text wrap theme={null}
Use Sevdesk and build a contacts page that lists organizations and person contacts. Include person contacts from Sevdesk when fetching /Contact.
```

## Limitations

The Sevdesk connector cannot:

* Create a Sevdesk account or API token for you
* Automatically rotate API tokens. To rotate a token, update the token in Sevdesk and update the Lovable connection
* Support per-end-user Sevdesk authentication. Each connection represents a single Sevdesk account shared across projects linked to it
* Bypass Sevdesk API limits, plan limits, or permissions on the connected Sevdesk user

## How to unlink projects from a {connector_0} connection

Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects.

To unlink projects:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

<Warning>
  Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>