PHPackages                             sensson/laravel-moneybird - 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. [Utility & Helpers](/categories/utility)
4. /
5. sensson/laravel-moneybird

ActiveLibrary[Utility & Helpers](/categories/utility)

sensson/laravel-moneybird
=========================

Moneybird

v0.4.0(1mo ago)17.5k—3%[1 PRs](https://github.com/sensson/laravel-moneybird/pulls)MITPHPPHP ^8.2CI passing

Since Mar 4Pushed 1w agoCompare

[ Source](https://github.com/sensson/laravel-moneybird)[ Packagist](https://packagist.org/packages/sensson/laravel-moneybird)[ Docs](https://github.com/sensson/laravel-moneybird)[ GitHub Sponsors](https://github.com/Sensson)[ RSS](/packages/sensson-laravel-moneybird/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (49)Versions (27)Used By (0)

Moneybird
=========

[](#moneybird)

[![Latest Version on Packagist](https://camo.githubusercontent.com/18b191af5fb078f3012ea852ae983cadc645dcb0bd57893c9ebaa3063b87417d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f73656e73736f6e2f6c61726176656c2d6d6f6e6579626972642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sensson/laravel-moneybird)[![GitHub Tests Action Status](https://camo.githubusercontent.com/cd007854d3a9bc6130d3aa5ba7723b7cdd116e34995c46021acf93769b81c0b4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f73656e73736f6e2f6c61726176656c2d6d6f6e6579626972642f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/sensson/laravel-moneybird/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/f021d52e93463bc08326f0714b1d36c6d71649d0e1b84eab15782f88e19b340b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f73656e73736f6e2f6c61726176656c2d6d6f6e6579626972642f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/sensson/laravel-moneybird/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/f257fa95362bf29439b603bbf5f25d29a431f0afb32985e4cc321973039ec855/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f73656e73736f6e2f6c61726176656c2d6d6f6e6579626972642e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/sensson/laravel-moneybird)

This package allows you to connect your Laravel application to the accounting software by [Moneybird](https://www.moneybird.nl).

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

[](#installation)

You can install the package via composer:

```
composer require sensson/laravel-moneybird
```

You can publish the config file with:

```
php artisan vendor:publish --tag="moneybird-config"
```

Usage
-----

[](#usage)

```
$moneybirdAdministrationId = '';
Moneybird::administration($moneybirdAdministrationId)->contacts()->all();
```

### Authentication / OAuth2

[](#authentication--oauth2)

You can use OAuth2 to authorize your application with Moneybird.

```
$moneybird = Moneybird::auth();
$url = $moneybird->getAuthorizationUrl();

session()->put('moneybird.state', $moneybird->getState());

return redirect()->to($url);
```

And process the callback from Moneybird:

```
$code = $request->string('code');
$state = $request->string('state');
$expected = session()->pull('moneybird.state');

$moneybird = Moneybird::auth();
$authorization = $moneybird->getAccessToken($code, $state, $expected);

// Store the $authorization details with a user or team
```

Both would typically be done in a custom controller. You can use the `$authorization` to call the Moneybird API:

```
$auth = $this->moneybird_auth;

if ($auth->hasExpired()) {
    $auth = Moneybird::auth()->make()->refreshAccessToken($auth);
    // Save new auth with the tenant or user
}

Moneybird::make()->authenticate($auth);
```

Resources
---------

[](#resources)

All resources are accessed through the `Moneybird` facade using the pattern: `Moneybird::administration($administrationId)->resourceName()`

### Administrations

[](#administrations)

Get all administrations:

```
$administrations = Moneybird::administrations()->all();
```

### Contacts

[](#contacts)

Get all contacts:

```
$administrationId = 'your-administration-id';
$contacts = Moneybird::administration($administrationId)->contacts()->all();
```

Get contacts with pagination and filters:

```
$contacts = Moneybird::administration($administrationId)->contacts()->all(
    perPage: 25,
    page: 1,
    query: 'search term',
    includeArchived: false,
    todo: 'todo filter'
);
```

Get a specific contact:

```
$contact = Moneybird::administration($administrationId)
    ->contacts()
    ->get('contact-id');
```

Create a new contact:

```
$contact = new Contact([
    'company_name' => 'Example Company',
    'firstname' => 'John',
    'lastname' => 'Doe'
]);
$createdContact = Moneybird::administration($administrationId)
    ->contacts()
    ->create($contact);
```

Update a contact:

```
$updatedContact = Moneybird::administration($administrationId)
    ->contacts()
    ->update('contact-id', $contact);
```

### Custom Fields

[](#custom-fields)

Get all custom fields:

```
$administrationId = 'your-administration-id';
$customFields = Moneybird::administration($administrationId)
    ->customFields()
    ->all();
```

### Financial Mutations

[](#financial-mutations)

Get all financial mutations. The list is limited to 100 records and accepts an optional Moneybird filter string:

```
$administrationId = 'your-administration-id';
$mutations = Moneybird::administration($administrationId)
    ->financialMutations()
    ->all(filter: 'period:this_month,state:unprocessed');
```

Get a specific financial mutation:

```
$mutation = Moneybird::administration($administrationId)
    ->financialMutations()
    ->get('financial-mutation-id');
```

To pull in more than 100 mutations, use synchronization. First retrieve the id and version of every mutation matching a filter, then fetch the full records in batches of up to 100:

```
$versions = Moneybird::administration($administrationId)
    ->financialMutations()
    ->synchronization('period:this_month,mutation_type:debit');

$ids = $versions->pluck('id')->take(100)->all();

$mutations = Moneybird::administration($administrationId)
    ->financialMutations()
    ->getByIds($ids);
```

Moneybird does not allow filtering mutations by invoice. To find the mutations that paid a sales invoice, inspect the payments on each mutation:

```
foreach ($mutations as $mutation) {
    foreach ($mutation->payments as $payment) {
        if ($payment->invoice_type === 'SalesInvoice' && $payment->invoice_id === $invoiceId) {
            // ...
        }
    }
}
```

Link a booking to a mutation:

```
$booking = new Booking([
    'booking_type' => 'LedgerAccount',
    'booking_id' => 'ledger-account-id',
    'price' => '10.00',
]);
Moneybird::administration($administrationId)
    ->financialMutations()
    ->linkBooking('financial-mutation-id', $booking);
```

Unlink a booking from a mutation:

```
$booking = new Booking([
    'booking_type' => 'Payment',
    'booking_id' => 'payment-id',
]);
Moneybird::administration($administrationId)
    ->financialMutations()
    ->unlinkBooking('financial-mutation-id', $booking);
```

### Ledgers

[](#ledgers)

Get all ledgers:

```
$administrationId = 'your-administration-id';
$ledgers = Moneybird::administration($administrationId)->ledgers()->all();
```

Get a specific ledger:

```
$ledger = Moneybird::administration($administrationId)
    ->ledgers()
    ->get('ledger-id');
```

Create a new ledger:

```
$ledger = new Ledger([
    'name' => 'New Ledger',
    'account_type' => AccountType::Expenses
]);
$createdLedger = Moneybird::administration($administrationId)
    ->ledgers()
    ->create($ledger, 'rgs-code');
```

Update a ledger:

```
$updatedLedger = Moneybird::administration($administrationId)
    ->ledgers()
    ->update('ledger-id', $ledger, 'rgs-code');
```

Delete a ledger:

```
Moneybird::administration($administrationId)
    ->ledgers()
    ->delete('ledger-id');
```

### Sales Invoices

[](#sales-invoices)

Get all sales invoices:

```
$administrationId = 'your-administration-id';
$invoices = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->all();
```

Get a specific sales invoice:

```
$invoice = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->get('invoice-id');
```

Find invoice by invoice ID:

```
$invoice = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->findByInvoiceId('2023-001');
```

Create a new sales invoice:

```
$invoice = new SalesInvoice([
    'contact_id' => 'contact-id',
    'invoice_date' => '2023-12-01'
]);
$createdInvoice = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->create($invoice);
```

Update a sales invoice:

```
$updatedInvoice = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->update('invoice-id', $invoice);
```

Delete a sales invoice:

```
Moneybird::administration($administrationId)
    ->salesInvoices()
    ->delete('invoice-id');
```

Download invoice as PDF:

```
$pdfContent = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->downloadPdf('invoice-id');
```

Download invoice as UBL:

```
$ublContent = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->downloadUbl('invoice-id');
```

Send invoice:

```
$sentInvoice = Moneybird::administration($administrationId)
    ->salesInvoices()
    ->send('invoice-id', DeliveryMethod::Email);
```

### Tax Rates

[](#tax-rates)

Get all tax rates:

```
$administrationId = 'your-administration-id';
$taxRates = Moneybird::administration($administrationId)->taxRates()->all();
```

Get tax rates with pagination and filters:

```
$taxRates = Moneybird::administration($administrationId)->taxRates()->all(
    perPage: 25,
    page: 1,
    filter: 'active'
);
```

### Webhooks

[](#webhooks)

Get all webhooks:

```
$administrationId = 'your-administration-id';
$webhooks = Moneybird::administration($administrationId)->webhooks()->all();
```

Create a new webhook:

```
$webhook = new Webhook([
    'url' => 'https://example.com/webhook',
    'events' => [WebhookEvent::SalesInvoiceCreated]
]);
$createdWebhook = Moneybird::administration($administrationId)
    ->webhooks()
    ->create($webhook);
```

Delete a webhook:

```
Moneybird::administration($administrationId)
    ->webhooks()
    ->delete('webhook-id');
```

### Workflows

[](#workflows)

Get all workflows:

```
$administrationId = 'your-administration-id';
$workflows = Moneybird::administration($administrationId)
    ->workflows()
    ->all();
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

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

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

[](#contributing)

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

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Sensson](https://github.com/sensson)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

49

—

FairBetter than 94% of packages

Maintenance96

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 90.8% 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 ~22 days

Recently: every ~30 days

Total

21

Last Release

35d ago

### Community

Maintainers

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

---

Top Contributors

[![ju5t](https://avatars.githubusercontent.com/u/3635751?v=4)](https://github.com/ju5t "ju5t (119 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (9 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")

---

Tags

laravellaravel-moneybirdSensson

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/sensson-laravel-moneybird/health.svg)

```
[![Health](https://phpackages.com/badges/sensson-laravel-moneybird/health.svg)](https://phpackages.com/packages/sensson-laravel-moneybird)
```

###  Alternatives

[codebar-ag/laravel-docuware

DocuWare integration with Laravel

1123.7k](/packages/codebar-ag-laravel-docuware)[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

329530.5k29](/packages/codewithdennis-filament-select-tree)[tarfin-labs/event-machine

Event-driven state machines for Laravel with event sourcing, type-safe context, and full audit trail.

199.4k](/packages/tarfin-labs-event-machine)[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)

PHPackages © 2026

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