PHPackages                             sq/laravel-sevdesk-api - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. sq/laravel-sevdesk-api

ActiveLibrary[API Development](/categories/api)

sq/laravel-sevdesk-api
======================

A helpful Sevdesk API client for Laravel.

v1.3(3y ago)090MITPHPPHP ^7.2|^8.0

Since Dec 14Pushed 3y agoCompare

[ Source](https://github.com/SimonSchlossarek/laravel-sevdesk-api-exlo89-fork)[ Packagist](https://packagist.org/packages/sq/laravel-sevdesk-api)[ Docs](https://github.com/exlo89/laravel-sevdesk-api)[ RSS](/packages/sq-laravel-sevdesk-api/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (3)Versions (6)Used By (0)

laravel sevdesk api
===================

[](#laravel-sevdesk-api)

[![Latest Version on Packagist](https://camo.githubusercontent.com/681349c4e55bd5bef02f950d9bcc7c5a54a44925c66a144422b2936aebfa99c7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f65786c6f38392f6c61726176656c2d7365766465736b2d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/exlo89/laravel-sevdesk-api)[![Total Downloads](https://camo.githubusercontent.com/c02c505f9e2a87bade462558096c0d937a8311c15ece89a9a753ee19d3f6d8ab/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f65786c6f38392f6c61726176656c2d7365766465736b2d6170692e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/exlo89/laravel-sevdesk-api)[![Test](https://github.com/exlo89/laravel-sevdesk-api/actions/workflows/testing.yml/badge.svg?branch=main)](https://github.com/exlo89/laravel-sevdesk-api/actions/workflows/testing.yml)

This package make a connection to the sevdesk api and let you interact with it.

[Sevdesk API Documentation](https://hilfe.sevdesk.de/knowledge/sevdesk-rest-full-api)

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require exlo89/laravel-sevdesk-api
```

Set your api token with

```
SEVDESK_API_TOKEN=xxxxxxxx

```

Optionally you can publish the config file with:

```
php artisan vendor:publish --provider="Exlo89\LaravelSevdeskApi\SevdeskApiServiceProvider" --tag="config"
```

This is the contents of the published config file:

```
return [
    /*
     * Api token you from sevdesk.
     */
    'api_token' => env('SEVDESK_API_TOKEN', ''),
];
```

Usage
-----

[](#usage)

First Instantiate a sevdesk instance.

```
$sevdeskApi = SevdeskApi::make();
```

### Create Contact

[](#create-contact)

Create sevdesk contacts. There are 4 different default contact types in sevdesk.

- supplier
- customer
- partner
- prospect customer

The optional `$parameters` is for additional information like description, vatNumber or bankNumber.

```
$sevdeskApi->contact()->createSupplier('Supplier Organisation', $parameters);
$sevdeskApi->contact()->createCustomer('Customer Organisation', $parameters);
$sevdeskApi->contact()->createPartner('Partner Organisation', $parameters);
$sevdeskApi->contact()->createProspectCustomer('Prospect Customer Organisation', $parameters);
```

For accounting contact you have to create a contact first. You create a accounting contact using the created contact id.

```
$sevdeskApi->contact()->createAccountingContact($contactId);
```

For custom contact types use your custom category id.

```
$sevdeskApi->contact()->createCustom('Custom Organisation', $categoryId, $parameters);
```

Check [Create Contact](https://my.sevdesk.de/api/ContactAPI/doc.html#operation/createContact) for more information.

### Retrieve Contact

[](#retrieve-contact)

To get all contacts.

```
$sevdeskApi->contact()->all();
$sevdeskApi->contact()->allSupplier();
$sevdeskApi->contact()->allCustomer();
$sevdeskApi->contact()->allPartner();
$sevdeskApi->contact()->allProspectCustomer();
```

To get all contacts from a custom type.

```
$sevdeskApi->contact()->allCustom($categoryId);
```

To get a single contact.

```
$sevdeskApi->contact()->get($contactId);
```

### Update Contact

[](#update-contact)

To update a single contact. `$contactId` is required.

```
$sevdeskApi->contact()->update($contactId, $parameters);
```

### Delete Contact

[](#delete-contact)

To delete a single contact. `$contactId` is required.

```
$sevdeskApi->contact()->delete($contactId);
```

### Create Contact Address

[](#create-contact-address)

```
$sevdeskApi->contactAddress()->create($contactId, $parameters);
```

### Create Communication Way

[](#create-communication-way)

Create phone number.

```
$sevdeskApi->communicationWay()->createPhone($contactId, $phoneNumber);
```

Create email.

```
$sevdeskApi->communicationWay()->createEmail($contactId, $email);
```

Create website.

```
$sevdeskApi->communicationWay()->createWebsite($contactId, $website);
```

### Retrieve Communication Way

[](#retrieve-communication-way)

Retrieve all communication ways.

```
$sevdeskApi->communicationWay()->all();
```

Retrieve communication ways of a specific contact.

```
$sevdeskApi->communicationWay()->get($contactId);
```

### Delete Communication Way

[](#delete-communication-way)

To delete a single communication way.

```
$sevdeskApi->communicationWay()->delete($communicationWayId);
```

### Retrieve Invoice

[](#retrieve-invoice)

To get all invoices.

```
$sevdeskApi->invoice()->all();
```

To get all invoices filtered by status `draft`, `open` or `payed`.

```
$sevdeskApi->invoice()->allDraft();
$sevdeskApi->invoice()->allOpen();
$sevdeskApi->invoice()->allPayed();
```

To get all invoices filtered by a giving `$contactId`.

```
$sevdeskApi->invoice()->allByContact($contactId);
```

To get all invoices filtered by giving `$timestamp`.

```
$sevdeskApi->invoice()->allAfter($timestamp);
$sevdeskApi->invoice()->allBefore($timestamp);
```

To download pdf file of the giving `$invoiceId`.

```
$sevdeskApi->invoice()->download($invoiceId);
```

To send invoice to giving `$email`. Use `$subject` and `$text` to edit the mail. `$text` can contain html.

```
$sevdeskApi->invoice()->sendPerMail($invoiceId, $email, $subject, $text);
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

### Security

[](#security)

If you discover any security related issues, please email [hello@martin-appelmann.de](mailto:hello@martin-appelmann.de?subject=Laravel%20Sevdesk%20Issue)instead of using the issue tracker.

Credits
-------

[](#credits)

- [Martin Appelmann](https://github.com/exlo89)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

Laravel Package Boilerplate
---------------------------

[](#laravel-package-boilerplate)

This package was generated using the [Laravel Package Boilerplate](https://laravelpackageboilerplate.com).

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

4

Last Release

1219d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ba640d8426e79bebd3d1ab88811c66e80cde8d485df950921b390ac645851c86?d=identicon)[SimonSchlossarek](/maintainers/SimonSchlossarek)

---

Top Contributors

[![exlo89](https://avatars.githubusercontent.com/u/16336438?v=4)](https://github.com/exlo89 "exlo89 (4 commits)")[![SimonSchlossarek](https://avatars.githubusercontent.com/u/112619866?v=4)](https://github.com/SimonSchlossarek "SimonSchlossarek (1 commits)")

---

Tags

phpapilaravelAccountingSEVDESK

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sq-laravel-sevdesk-api/health.svg)

```
[![Health](https://phpackages.com/badges/sq-laravel-sevdesk-api/health.svg)](https://phpackages.com/packages/sq-laravel-sevdesk-api)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[mozex/anthropic-laravel

Anthropic PHP for Laravel is a supercharged PHP API client that allows you to interact with the Anthropic API

71226.4k1](/packages/mozex-anthropic-laravel)[exlo89/laravel-sevdesk-api

A helpful Sevdesk API client for Laravel.

1116.5k](/packages/exlo89-laravel-sevdesk-api)[scriptdevelop/whatsapp-manager

Paquete para manejo de WhatsApp Business API en Laravel

762.6k](/packages/scriptdevelop-whatsapp-manager)[dariusiii/tmdb-laravel

Laravel Package for TMDB ( The Movie Database ) API. Provides easy access to the wtfzdotnet/php-tmdb-api library.

1821.1k](/packages/dariusiii-tmdb-laravel)[jeroen-g/flickr

Modern PHP package to make Flickr API calls. Ships with Laravel implementation.

2559.9k2](/packages/jeroen-g-flickr)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
