> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maesn.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Moneybird
> Integrate Moneybird easily with Maesn’s Unified API. See the documentation with detailed system coverage and setup prerequisites.
**TARGET\_SYSTEM:** `moneybird`
| | Read | Create | Update | Delete | Webhook | |
| -------------------- | :----------------------------------------------------: | :----------------------------------------------------: | :----------------------------------------------------: | :----------------------------------------------------: | :----------------------------------------------------: | - |
| Accounts | | | | | | |
| Async task | | | | | | |
| Bank accounts | | | | | | |
| Bills | | | | | | |
| Bill lines | | | | | | |
| Booking proposals | | | | | | |
| Contacts | | | | | | |
| Customers | | | | | | |
| Credit notes | | | | | | |
| Dimensions | | | | | | |
| Expenses | | | | | | |
| Files | | | | | | |
| Fiscal years | | | | | | |
| Goods receipts | | | | | | |
| Goods receipt lines | | | | | | |
| Invoices | | | | | | |
| Invoice lines | | | | | | |
| Items | | | | | | |
| Journals | | | | | | |
| Journal entries | | | | | | |
| Offers | | | | | | |
| Offer lines | | | | | | |
| Open items | | | | | | , |
| Payments | | | | | | |
| Payment terms | | | | | | |
| Projects | | | | | | |
| Purchase orders | | | | | | |
| Purchase order lines | | | | | | |
| Sales orders | | | | | | |
| Sales order lines | | | | | | |
| Suppliers | | | | | | |
| Tax rates | | | | | | |
| Transactions | | | | | | |
| Trial balance | | | | | | |
| Units | | | | | | |
| Users | | | | | | |
| Vendor credits | | | | | | |
= Supported by Maesn
= On demand - contact us
= Not supported by Moneybird
## How to connect to Moneybird
To allow your customers to link your application with their Moneybird account, you need to set up an App and submit your application credentials to maesn.
Before you begin, make sure you have the following:
* A Moneybird account with administrator permissions.
You can sign-up for a free trial at [https://www.moneybird.com/aanmelden/](https://www.moneybird.com/aanmelden/), if you do not have a Moneybird account already.
To set up your application in Moneybird, follow the following instructions.
* Navigate to the [Moneybird Portal](https://moneybird.com/user/applications/new).
* Login with your Moneybird account.
* In the **Create API token** section enter a name for your app and set the redirect URL to: `https://api.maesn.dev/auth/callback/moneybird`.
* Click **Save**.
* Once configured, you can retrieve the Client ID and Client Secret for your application.
Next we configure your API tenant with your client's details:
* Get in touch with your contact person at maesn to submit the client id and client secret.
If you are not sure who your technical contact is, don’t hesitate to [reach out to us](https://www.maesn.com/contact).
## Becoming a Moneybird Partner
Information on becoming a partner can be found on their [partner page](https://www.moneybird.nl/partners/).
## Webhooks
Moneybird supports the following parameters for webhooks:
Resources:
* `CONTACT`
* `INVOICE`
* `PAYMENT`
* `TAX_RATE`
Event types:
* `CREATED`
* `DELETED`
* `UPDATED`
Moneybird needs both resource and event type to be able to send webhook events.
The subscription is created **per customer**, which means for each customer, you will create a customized subscription for the events and resources you want to be notified about.
To set this up, call Maesn's create webhook endpoint `POST /webhooks?companyId=` (`companyId` query parameter required if not using the interactive flow) with the following example body:
```javascript Example code snippet theme={null}
const response = await axios.post(url, {
"callbackUrl": callbackUrl,
"eventType": "CREATED",
"resource": "CONTACT"
}, {
headers: {
'X-API-KEY': apiKey,
'X-ACCOUNT-KEY': accountKey
}
});
```
It will return the `id` associated with the subscription:
```json Example response theme={null}
{
"data": {
"id": "830251",
"callbackUrl": "https://example.com/webhook-endpoint/12345",
"createdDate": null,
"expiresDate": "null",
"secret": "2f1fd5f883d4c0adf5b31b91e4d6ae2d2975620c67bac8fdb864c78047b1d522"
"updatedDate": "null"
},
"meta": {}
}
```
At this point, your system is ready to receive end-user–related events at the callback URL you provided. The event response will provide the following information:
```json Example event body theme={null}
{
"eventType": "CREATED",
"filterDate": null, //not supported by moneybird
"resource": "CONTACT",
"resourceId": "476677322389325515",
"userId": null //not supported by moneybird
}
```
To delete the webhook subscription, you can call the `DELETE` `/webhooks/{webhookId}?companyId=` endpoint provinding both your `X-API-KEY` and the end user `X-ACCOUNT-KEY`.