Skip to main content
Moneybird logo
  • Category: accounting
  • Auth: OAUTH2, API_KEY
  • Composio-managed OAuth available? Yes
  • Tools: 21
  • Triggers: 0
  • Slug: MONEYBIRD
  • Version: 20261101_00

Tools

Slug: MONEYBIRD_ADD_NOTE_TO_CONTACTTool 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

object
required
Payload containing the note details
string
required
ID of the contact to which the note will be added
string
required
Numeric administration ID, part of the Moneybird URL path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_ARCHIVE_CONTACTTool to archive a contact. Use when a contact is no longer needed and should be hidden permanently.

Input Parameters

integer
required
The unique identifier of the contact to archive
integer
required
The unique identifier of the administration

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_CREATE_CONTACTTool 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

string
City name
string
Phone number
string
ISO 3166-1 alpha-2 country code, e.g., NL
string
Postal code
string
Street and number
string
Additional address line
string
Last name; required if company_name is blank
string
Valid BIC; required if sepa_active
string
First name; required if company_name is blank
string
Valid IBAN; required if sepa_active
string
Tax/VAT number
string
Unique customer identifier; autogenerated if empty
boolean
Enable SEPA direct debit; when true, other SEPA fields are required
string
Bank account number
string
Company name; required if firstname and lastname are blank
string
SEPA identifier
string ("Email" | "Simplerinvoicing" | "Peppol" | "Manual" | "Post")
Delivery method
string
Mandate ID; required if sepa_active
string
required
ID of the administration
string
Mandate date (YYYY-MM-DD); required if sepa_active
string ("RCUR" | "FRST" | "OOFF" | "FNAL")
SEPA sequence type; required if sepa_active
string
SEPA identifier type
string
Chamber of Commerce number
string
Invoice workflow ID
string
Estimate workflow ID
string
Comma-separated emails to send invoices to
string
Account holder name for SEPA
string
Comma-separated emails to send estimates to
object
Custom fields as dict of {index:{id, value}}

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_CREATE_CONTACT_PERSONTool 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

integer
required
ID of the contact under which the person will be created
object
required
Container for all contact person fields
integer
required
ID of the administration under which the contact person will be created

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_CREATE_SALES_INVOICETool to create a new sales invoice. Use when you need to bill a contact with specified line items.

Input Parameters

object
required
Sales invoice data to create
integer
required
Numeric administration ID, part of the Moneybird URL path

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_DELETE_CONTACTTool to delete a contact. Use after confirming that contact should be removed.

Input Parameters

integer
required
ID of the contact to delete
integer
required
ID of the administration

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_DELETE_CONTACT_NOTETool to delete a note from a contact. Use when a note is no longer needed and should be removed permanently.

Input Parameters

integer
required
The unique identifier of the note to delete
integer
required
The unique identifier of the contact
integer
required
The unique identifier of the administration

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_DELETE_CONTACT_PERSONTool to delete a contact person from a contact. Use after confirming the administration_id, contact_id, and contact_person_id.

Input Parameters

integer
required
The ID of the contact from which to remove a person
integer
required
The Moneybird administration ID under which the contact resides
integer
required
The ID of the contact person to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_FILTER_CONTACTSTool to filter contacts. Use when you need to retrieve contacts matching specific criteria like created_after or first_name.

Input Parameters

integer
Number of contacts to return per page (1-100)
string
Filter contacts by last name (case-insensitive)
string
Filter contacts by first name (case-insensitive)
string
Select contacts created after this ISO 8601 UTC datetime (exclusive), e.g., ‘2025-05-06T07:27:49Z’
string
Select contacts updated after this ISO 8601 UTC datetime (exclusive), e.g., ‘2025-05-07T07:27:54Z’
boolean
Include archived contacts in the results
string
required
Numeric administration ID for the Moneybird URL path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_GET_ADDITIONAL_CHARGESTool to get additional charges for a contact. Use when you need to view pending (or optionally billed) usage or recurring charges.

Input Parameters

string
required
ID of the contact to retrieve additional charges for
boolean
If true, includes additional charges that have already been billed. Default is false.
string
required
Numeric administration ID, as part of the Moneybird URL path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_GET_CONTACTTool 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

string
required
ID of the contact to retrieve
boolean
Return archived contact when true (default false)
string
required
Numeric administration ID, part of the Moneybird URL path

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_GET_CONTACT_BY_CUSTOMER_IDTool to retrieve full contact details by customer ID. Use when you need all fields of a contact given its customer_id.

Input Parameters

string
required
Unique customer identifier for the contact.
string
required
Numeric administration ID, used in the URL path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_GET_CONTACT_PERSONTool 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

integer
required
The ID of the contact to which the person belongs.
integer
required
Numeric administration ID, used in the URL path.
integer
required
The ID of the contact person to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_GET_SALES_INVOICETool to get a single sales invoice by ID. Use when you need detailed invoice data for a known invoice ID.

Input Parameters

string
required
ID of the sales invoice to retrieve
string
required
Numeric administration ID, part of the Moneybird URL path

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_LIST_ADMINISTRATIONSTool to list all administrations accessible by the authenticated user. Use when you need to obtain administration_id for subsequent operations like create_contact.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_LIST_CONTACTS_SYNCHRONIZATIONTool 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

string
Optional filter expression to narrow results, e.g., ‘first_name:henk’
boolean
If true, include archived contacts in the synchronization list
string
required
The unique identifier of the administration

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_LIST_SALES_INVOICESList sales invoice overviews for an administration, with optional filtering and pagination. Each call retrieves one page.

Input Parameters

integer
Page number for pagination (must be >= 1).
string
Filter expression to limit invoices. See Moneybird docs for supported filters, e.g., ‘state=sent’ or ‘period=current_year’.
integer
Number of invoices per page (max 100).
string
required
Numeric administration ID, part of the Moneybird URL path

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_REQUEST_CONTACT_PAYMENTS_MANDATE_URLTool 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

integer
required
ID of the contact for which to generate a payments mandate URL
integer
Optional identity ID when multiple identities exist; must be a valid identity.
integer
required
Numeric administration ID, as part of the Moneybird URL path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_UPDATE_CONTACTTool to update a contact. Use when you need to modify existing contact details by ID. Only provided fields will be changed.

Input Parameters

object
required
Key-value map of contact fields to update
string
required
ID of the contact to update
string
required
Numeric administration ID, part of the Moneybird URL path

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_UPDATE_CONTACT_PERSONTool to update a contact person. Use after selecting a specific contact person when you need to change their details.

Input Parameters

string
Email address of the contact person.
string
Phone number of the contact person.
string
Last name of the contact person.
string
First name of the contact person.
string
required
ID of the contact containing the person to update.
string
Department of the contact person.
integer
required
Numeric administration ID, part of the Moneybird URL path.
string
required
ID of the contact person to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MONEYBIRD_UPDATE_SALES_INVOICETool to update an existing sales invoice by ID. Use when modifying invoice header or line items.

Input Parameters

object
required
Fields to update on the invoice
string
required
ID of the sales invoice to update
integer
required
Administration ID in Moneybird URL path

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not