Moneybird

Learn how to use Moneybird with Composio

Overview

SLUG

MONEYBIRD

Description

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

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to sales_invoices
bearer_token
string
bearer_token
stringRequired

Tools

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.

Action Parameters

administration_id
integerRequired
contact_id
stringRequired
note
objectRequired

Action Response

administration_id
integerRequired
assignee_id
string
completed_at
string
completed_by_id
string
created_at
stringRequired
data
objectRequired
entity_id
stringRequired
entity_type
stringRequired
error
string
id
stringRequired
note
stringRequired
successful
booleanRequired
todo
booleanRequired
todo_type
string
updated_at
stringRequired
user_id
integerRequired

SLUG: MONEYBIRD_ARCHIVE_CONTACT

Tool to archive a contact. use when a contact is no longer needed and should be hidden permanently.

Action Parameters

administration_id
integerRequired
contact_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

address1
string
address2
string
administration_id
integerRequired
bank_account
string
chamber_of_commerce
string
city
string
company_name
string
country
custom_fields_attributes
object
customer_id
string
delivery_method
string
estimate_workflow_id
integer
firstname
string
invoice_workflow_id
integer
lastname
string
phone
string
send_estimates_to_email
send_invoices_to_email
sepa_active
boolean
sepa_bic
string
sepa_iban
string
sepa_iban_account_name
string
sepa_mandate_date
string
sepa_mandate_id
string
sepa_sequence_type
string
si_identifier
string
si_identifier_type
string
tax_number
string
zipcode
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact_id
integerRequired
contact_person
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: MONEYBIRD_CREATE_SALES_INVOICE

Tool to create a new sales invoice. use when you need to bill a contact with specified line items.

Action Parameters

administration_id
integerRequired
sales_invoice
objectRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: MONEYBIRD_DELETE_CONTACT

Tool to delete a contact. use after confirming that contact should be removed.

Action Parameters

administration_id
integerRequired
contact_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact_id
integerRequired
note_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact_id
integerRequired
contact_person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: MONEYBIRD_FILTER_CONTACTS

Tool to filter contacts. use when you need to retrieve contacts matching specific criteria like created after or first name.

Action Parameters

administration_id
integerRequired
created_after
string
first_name
string
include_archived
boolean
last_name
string
per_page
integer
updated_after
string

Action Response

data
arrayRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact_id
stringRequired
include_billed
boolean

Action Response

data
arrayRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact_id
stringRequired
include_archived
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
customer_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact_id
integerRequired
contact_person_id
integerRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
invoice_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

Action Response

data
arrayRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
filter
string
include_archived
boolean

Action Response

data
arrayRequired
error
string
successful
booleanRequired

SLUG: MONEYBIRD_LIST_SALES_INVOICES

Tool to list all sales invoices in an administration. use when you need an overview of invoices for a given administration.

Action Parameters

administration_id
integerRequired
filter
string
page
integer
per_page
integer

Action Response

data
arrayRequired
error
string
successful
booleanRequired

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).

Action Parameters

administration_id
integerRequired
contact_id
integerRequired
identity_id
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact
objectRequired
contact_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

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.

Action Parameters

administration_id
integerRequired
contact_id
stringRequired
contact_person_id
stringRequired
department
string
email
string
firstname
string
lastname
string
phone
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: MONEYBIRD_UPDATE_SALES_INVOICE

Tool to update an existing sales invoice by id. use when modifying invoice header or line items.

Action Parameters

administration_id
integerRequired
sales_invoice
objectRequired
sales_invoice_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired