Skip to main content
TARGET_SYSTEM: moneybird
ReadCreateUpdateDeleteWebhook
Accounts
Async task
Bank accounts
Bills
Bill lines
Booking proposals
Contacts
Customers
Credit notes
Dimensions
Expenses
Files
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.
1

Prerequisites

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/, if you do not have a Moneybird account already.
2

Set up an App

To set up your application in Moneybird, follow the following instructions.
3

Configure your integration in the maesn API

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.

​
Becoming a Moneybird Partner

Information on becoming a partner can be found on their partner page.

​
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> (companyId query parameter required if not using the interactive flow) with the following example body:
Example code snippet
    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:
Example response
{
    "data": {
        "id": "830251",
         ...
    },
    "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:
Example event body
{
  "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=<companyId> endpoint provinding both your X-API-KEY and the end user X-ACCOUNT-KEY.
Last modified on January 29, 2026