> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Moneybird

> Moneybird is an online invoicing and accounting platform designed for small businesses and freelancers, offering features like invoicing, expense tracking, and financial reporting.

![Moneybird logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/moneybird.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=6e6f18ed0f19abf85d07de55a7fe9607)

* **Category:** accounting
* **Auth:** OAUTH2, API\_KEY
* **Composio-managed OAuth available?** Yes
* **Tools:** 21
* **Triggers:** 0
* **Slug:** `MONEYBIRD`
* **Version:** 20261101\_00

## Tools

> [accordion] Add Note to Contact
>
> **Slug:** `MONEYBIRD_ADD_NOTE_TO_CONTACT`
>
> Tool to add a note or to-do to a contact. Use when you need to record a comment or assign a task to a contact.
>
> #### Input Parameters
>
> **note** `object` *required*
>
> Payload containing the note details
>
> **contact\_id** `string` *required*
>
> ID of the contact to which the note will be added
>
> **administration\_id** `string` *required*
>
> Numeric administration ID, part of the Moneybird URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Archive Contact
>
> **Slug:** `MONEYBIRD_ARCHIVE_CONTACT`
>
> Tool to archive a contact. Use when a contact is no longer needed and should be hidden permanently.
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> The unique identifier of the contact to archive
>
> **administration\_id** `integer` *required*
>
> The unique identifier of the administration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Moneybird Contact
>
> **Slug:** `MONEYBIRD_CREATE_CONTACT`
>
> Tool to create a new contact in Moneybird. Use after you have an administration ID and need to onboard a new company/person. Provide either company\_name or both firstname and lastname.
>
> #### Input Parameters
>
> **city** `string`
>
> City name
>
> **phone** `string`
>
> Phone number
>
> **country** `string`
>
> ISO 3166-1 alpha-2 country code, e.g., NL
>
> **zipcode** `string`
>
> Postal code
>
> **address1** `string`
>
> Street and number
>
> **address2** `string`
>
> Additional address line
>
> **lastname** `string`
>
> Last name; required if company\_name is blank
>
> **sepa\_bic** `string`
>
> Valid BIC; required if sepa\_active
>
> **firstname** `string`
>
> First name; required if company\_name is blank
>
> **sepa\_iban** `string`
>
> Valid IBAN; required if sepa\_active
>
> **tax\_number** `string`
>
> Tax/VAT number
>
> **customer\_id** `string`
>
> Unique customer identifier; autogenerated if empty
>
> **sepa\_active** `boolean`
>
> Enable SEPA direct debit; when true, other SEPA fields are required
>
> **bank\_account** `string`
>
> Bank account number
>
> **company\_name** `string`
>
> Company name; required if firstname and lastname are blank
>
> **si\_identifier** `string`
>
> SEPA identifier
>
> **delivery\_method** `string ("Email" | "Simplerinvoicing" | "Peppol" | "Manual" | "Post")`
>
> Delivery method
>
> **sepa\_mandate\_id** `string`
>
> Mandate ID; required if sepa\_active
>
> **administration\_id** `string` *required*
>
> ID of the administration
>
> **sepa\_mandate\_date** `string`
>
> Mandate date (YYYY-MM-DD); required if sepa\_active
>
> **sepa\_sequence\_type** `string ("RCUR" | "FRST" | "OOFF" | "FNAL")`
>
> SEPA sequence type; required if sepa\_active
>
> **si\_identifier\_type** `string`
>
> SEPA identifier type
>
> **chamber\_of\_commerce** `string`
>
> Chamber of Commerce number
>
> **invoice\_workflow\_id** `string`
>
> Invoice workflow ID
>
> **estimate\_workflow\_id** `string`
>
> Estimate workflow ID
>
> **send\_invoices\_to\_email** `string`
>
> Comma-separated emails to send invoices to
>
> **sepa\_iban\_account\_name** `string`
>
> Account holder name for SEPA
>
> **send\_estimates\_to\_email** `string`
>
> Comma-separated emails to send estimates to
>
> **custom\_fields\_attributes** `object`
>
> Custom fields as dict of \{index:\{id, value}}
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Contact Person
>
> **Slug:** `MONEYBIRD_CREATE_CONTACT_PERSON`
>
> Tool to create a new contact person. Use when you have the contact ID and need to add a person after confirming their firstname and lastname.
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> ID of the contact under which the person will be created
>
> **contact\_person** `object` *required*
>
> Container for all contact person fields
>
> **administration\_id** `integer` *required*
>
> ID of the administration under which the contact person will be created
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Sales Invoice
>
> **Slug:** `MONEYBIRD_CREATE_SALES_INVOICE`
>
> Tool to create a new sales invoice. Use when you need to bill a contact with specified line items.
>
> #### Input Parameters
>
> **sales\_invoice** `object` *required*
>
> Sales invoice data to create
>
> **administration\_id** `integer` *required*
>
> Numeric administration ID, part of the Moneybird URL path
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact
>
> **Slug:** `MONEYBIRD_DELETE_CONTACT`
>
> Tool to delete a contact. Use after confirming that contact should be removed.
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> ID of the contact to delete
>
> **administration\_id** `integer` *required*
>
> ID of the administration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact Note
>
> **Slug:** `MONEYBIRD_DELETE_CONTACT_NOTE`
>
> Tool to delete a note from a contact. Use when a note is no longer needed and should be removed permanently.
>
> #### Input Parameters
>
> **note\_id** `integer` *required*
>
> The unique identifier of the note to delete
>
> **contact\_id** `integer` *required*
>
> The unique identifier of the contact
>
> **administration\_id** `integer` *required*
>
> The unique identifier of the administration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Contact Person
>
> **Slug:** `MONEYBIRD_DELETE_CONTACT_PERSON`
>
> Tool to delete a contact person from a contact. Use after confirming the administration\_id, contact\_id, and contact\_person\_id.
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> The ID of the contact from which to remove a person
>
> **administration\_id** `integer` *required*
>
> The Moneybird administration ID under which the contact resides
>
> **contact\_person\_id** `integer` *required*
>
> The ID of the contact person to delete
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Filter Contacts
>
> **Slug:** `MONEYBIRD_FILTER_CONTACTS`
>
> Tool to filter contacts. Use when you need to retrieve contacts matching specific criteria like created\_after or first\_name.
>
> #### Input Parameters
>
> **per\_page** `integer`
>
> Number of contacts to return per page (1-100)
>
> **last\_name** `string`
>
> Filter contacts by last name (case-insensitive)
>
> **first\_name** `string`
>
> Filter contacts by first name (case-insensitive)
>
> **created\_after** `string`
>
> Select contacts created after this ISO 8601 UTC datetime (exclusive), e.g., '2025-05-06T07:27:49Z'
>
> **updated\_after** `string`
>
> Select contacts updated after this ISO 8601 UTC datetime (exclusive), e.g., '2025-05-07T07:27:54Z'
>
> **include\_archived** `boolean`
>
> Include archived contacts in the results
>
> **administration\_id** `string` *required*
>
> Numeric administration ID for the Moneybird URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Additional Charges
>
> **Slug:** `MONEYBIRD_GET_ADDITIONAL_CHARGES`
>
> Tool to get additional charges for a contact. Use when you need to view pending (or optionally billed) usage or recurring charges.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> ID of the contact to retrieve additional charges for
>
> **include\_billed** `boolean`
>
> If true, includes additional charges that have already been billed. Default is false.
>
> **administration\_id** `string` *required*
>
> Numeric administration ID, as part of the Moneybird URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact
>
> **Slug:** `MONEYBIRD_GET_CONTACT`
>
> Tool to retrieve all information about a specific contact by ID. Use when you need the full details of a contact, for example before generating invoices.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> ID of the contact to retrieve
>
> **include\_archived** `boolean`
>
> Return archived contact when true (default false)
>
> **administration\_id** `string` *required*
>
> Numeric administration ID, part of the Moneybird URL path
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact by Customer ID
>
> **Slug:** `MONEYBIRD_GET_CONTACT_BY_CUSTOMER_ID`
>
> Tool to retrieve full contact details by customer ID. Use when you need all fields of a contact given its customer\_id.
>
> #### Input Parameters
>
> **customer\_id** `string` *required*
>
> Unique customer identifier for the contact.
>
> **administration\_id** `string` *required*
>
> Numeric administration ID, used in the URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Contact Person
>
> **Slug:** `MONEYBIRD_GET_CONTACT_PERSON`
>
> Tool to get all information about a contact person. Use when you have the administration, contact, and contact person IDs and need full details before updating.
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> The ID of the contact to which the person belongs.
>
> **administration\_id** `integer` *required*
>
> Numeric administration ID, used in the URL path.
>
> **contact\_person\_id** `integer` *required*
>
> The ID of the contact person to retrieve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Sales Invoice
>
> **Slug:** `MONEYBIRD_GET_SALES_INVOICE`
>
> Tool to get a single sales invoice by ID. Use when you need detailed invoice data for a known invoice ID.
>
> #### Input Parameters
>
> **invoice\_id** `string` *required*
>
> ID of the sales invoice to retrieve
>
> **administration\_id** `string` *required*
>
> Numeric administration ID, part of the Moneybird URL path
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Administrations
>
> **Slug:** `MONEYBIRD_LIST_ADMINISTRATIONS`
>
> Tool to list all administrations accessible by the authenticated user. Use when you need to obtain administration\_id for subsequent operations like create\_contact.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Contacts Synchronization
>
> **Slug:** `MONEYBIRD_LIST_CONTACTS_SYNCHRONIZATION`
>
> Tool to list all contact IDs and versions for synchronization. Use when you need to detect which contacts have changed and update local data accordingly.
>
> #### Input Parameters
>
> **filter** `string`
>
> Optional filter expression to narrow results, e.g., 'first\_name:henk'
>
> **include\_archived** `boolean`
>
> If true, include archived contacts in the synchronization list
>
> **administration\_id** `string` *required*
>
> The unique identifier of the administration
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Sales Invoices
>
> **Slug:** `MONEYBIRD_LIST_SALES_INVOICES`
>
> List sales invoice overviews for an administration, with optional filtering and pagination. Each call retrieves one page.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (must be >= 1).
>
> **filter** `string`
>
> Filter expression to limit invoices. See Moneybird docs for supported filters, e.g., 'state=sent' or 'period=current\_year'.
>
> **per\_page** `integer`
>
> Number of invoices per page (max 100).
>
> **administration\_id** `string` *required*
>
> Numeric administration ID, part of the Moneybird URL path
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Request Payments Mandate URL
>
> **Slug:** `MONEYBIRD_REQUEST_CONTACT_PAYMENTS_MANDATE_URL`
>
> Tool to request a URL for setting up a Payments mandate. Use when you need to generate a direct-debit authorization link for a contact (valid for 14 days).
>
> #### Input Parameters
>
> **contact\_id** `integer` *required*
>
> ID of the contact for which to generate a payments mandate URL
>
> **identity\_id** `integer`
>
> Optional identity ID when multiple identities exist; must be a valid identity.
>
> **administration\_id** `integer` *required*
>
> Numeric administration ID, as part of the Moneybird URL path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact
>
> **Slug:** `MONEYBIRD_UPDATE_CONTACT`
>
> Tool to update a contact. Use when you need to modify existing contact details by ID. Only provided fields will be changed.
>
> #### Input Parameters
>
> **contact** `object` *required*
>
> Key-value map of contact fields to update
>
> **contact\_id** `string` *required*
>
> ID of the contact to update
>
> **administration\_id** `string` *required*
>
> Numeric administration ID, part of the Moneybird URL path
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Contact Person
>
> **Slug:** `MONEYBIRD_UPDATE_CONTACT_PERSON`
>
> Tool to update a contact person. Use after selecting a specific contact person when you need to change their details.
>
> #### Input Parameters
>
> **email** `string`
>
> Email address of the contact person.
>
> **phone** `string`
>
> Phone number of the contact person.
>
> **lastname** `string`
>
> Last name of the contact person.
>
> **firstname** `string`
>
> First name of the contact person.
>
> **contact\_id** `string` *required*
>
> ID of the contact containing the person to update.
>
> **department** `string`
>
> Department of the contact person.
>
> **administration\_id** `integer` *required*
>
> Numeric administration ID, part of the Moneybird URL path.
>
> **contact\_person\_id** `string` *required*
>
> ID of the contact person to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Sales Invoice
>
> **Slug:** `MONEYBIRD_UPDATE_SALES_INVOICE`
>
> Tool to update an existing sales invoice by ID. Use when modifying invoice header or line items.
>
> #### Input Parameters
>
> **sales\_invoice** `object` *required*
>
> Fields to update on the invoice
>
> **sales\_invoice\_id** `string` *required*
>
> ID of the sales invoice to update
>
> **administration\_id** `integer` *required*
>
> Administration ID in Moneybird URL path
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
