holded

name

holded

description

Holded is an all-in-one cloud-based business management platform that enables small and medium-sized businesses to manage accounting, invoicing, CRM, inventory, projects, and HR from a single integrated system, automating workflows and centralizing operations for improved efficiency. Read and write Holded data through One: documents, employees, products, leads, projects, funnels and more, 136 actions with real parameter documentation. Use whenever the user asks to look something up in Holded, create or update a record there, or build code against the Holded API.

Holded through One

Holded is an all-in-one cloud-based business management platform that enables small and medium-sized businesses to manage accounting, invoicing, CRM, inventory, projects, and HR from a single integrated system, automating workflows and centralizing operations for improved efficiency.

One exposes Holded through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform holded if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Holded is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Holded account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Documents

Action	Method	Path	Action id
Get a Document PDF	GET	/api/invoicing/v1/documents/{{docType}}/{{documentId}}/pdf	conn_mod_def::GKYtn80YV_A::qfDyDSuZSKGHEq1x_ed0WQ
Get Document	GET	/api/invoicing/v1/documents/{{docType}}/{{documentId}}	conn_mod_def::GKYtnzYTVTA::0HCKQLyZS9K9bOs1v4dAqg
Get Shipped Units by Item for a Document	GET	/api/invoicing/v1/documents/{{docType}}/{{documentId}}/shippeditems	conn_mod_def::GKYtoGEeCRg::pltLcvEXSBOYJ3WRzStSBg
List Documents	GET	/api/invoicing/v1/documents/{{docType}}	conn_mod_def::GKYtn19Gnqg::AwK4IFOZT6qolb_MJZEZlA
Attach File to a Specific Document	POST	/api/invoicing/v1/documents/{{docType}}/{{documentId}}/attach	conn_mod_def::GKYtnqpkHdA::_D_j-VgGQIWSTnYcup7hNg
Create Document	POST	/api/invoicing/v1/documents/{{docType}}	conn_mod_def::GKYtnqiKCog::gNyU1X2gS42fi8WK0qkwyQ
Delete Document	DELETE	/api/invoicing/v1/documents/{{docType}}/{{documentId}}	conn_mod_def::GKYtnzYc3pg::KuHRyPNbQ3mZbYG1UxtqQg
Pay Document	POST	/api/invoicing/v1/documents/{{docType}}/{{documentId}}/pay	conn_mod_def::GKYtoGWCA2A::obfZYGhIToeKqS1lJ81-Hg
Send a Specific Document by Email	POST	/api/invoicing/v1/documents/{{docType}}/{{documentId}}/send	conn_mod_def::GKYtoF-xXaA::xGdwldJoRDm3FgihJCJU_g
Update a Document	PUT	/api/invoicing/v1/documents/{{docType}}/{{documentId}}	conn_mod_def::GKYtoPLbrqA::GEwYzVL6RImZkEQaE3PjuQ
Update a Specific Document Pipeline	POST	/api/invoicing/v1/documents/{{docType}}/{{documentId}}/pipeline/set

Employees

Action	Method	Path	Action id
Get an Employee	GET	/api/team/v1/employees/{{employeeId}}	conn_mod_def::GKYtocFO1Sg::3cFSu7E4QpuWX2zX-9-VWg
List Employees	GET	/api/team/v1/employees	conn_mod_def::GKYtof-mu4g::RTNbfgPASNqWqehktliNSw
Clock In an Employee's Time Tracking	POST	/api/team/v1/employees/{{employeeId}}/times/clockin	conn_mod_def::GKYtotyZ18g::-yyZ5xdvQG2IKT4vAUrhkw
Clock Out an Employee's Time Tracking	POST	/api/team/v1/employees/{{employeeId}}/times/clockout	conn_mod_def::GKYtorcpBPA::BjIqeP5yRB2NfCp-KtSoXQ
Create Employee	POST	/api/team/v1/employees	conn_mod_def::GKYtoO7Ruzg::Cay7Szp-SuKed0_6Wo3hEA
Delete an Employee	DELETE	/api/team/v1/employees/{{employeeId}}	conn_mod_def::GKYtoOzpySg::574Nlr_ySimv-dT4zfBxyA
Pause an Employee's Time-Tracking	POST	/api/team/v1/employees/{{employeeId}}/times/pause	conn_mod_def::GKYtovsfTeA::4RQSLqRARa-4SVpLhoDKlg
Unpause an Employee's Time-Tracking	POST	/api/team/v1/employees/{{employeeId}}/times/unpause	conn_mod_def::GKYtorEUk7g::di17ZjIXQaOI2ueqeIgGxg
Update an Employee	PUT	/api/team/v1/employees/{{employeeId}}	conn_mod_def::GKYtoa6zY8A::pT5a0QK1RGeWq6dY7T445g

Products

Action	Method	Path	Action id
Get a Product Secondary Image	GET	/api/invoicing/v1/products/{{productId}}/image/{{imageFileName}}	conn_mod_def::GKYtqR9YByg::6bMvkDpfRCSX6AOFdJOErA
Get a Product's Main Image	GET	/api/invoicing/v1/products/{{productId}}/image	conn_mod_def::GKYtqLIQ0tA::-C6llkgoSwCL7HtBdAbPKw
Get Product	GET	/api/invoicing/v1/products/{{productId}}	conn_mod_def::GKYtqLJxgNA::mqfPKBeaS42WwyzO7Wt5Jw
List a Product's Images	GET	/api/invoicing/v1/products/{{productId}}/imagesList	conn_mod_def::GKYtqLaY7xg::d2bKmOMNQ1Cdf_Sgi_Hy0Q
List Products	GET	/api/invoicing/v1/products	conn_mod_def::GKYtqYxtjMA::fPNgRZ_PSgm8pY8Qfx-COw
Create Product	POST	/api/invoicing/v1/products	conn_mod_def::GKYtqCLgktA::RRV4XYWYTKesXXwDq0dCWg
Delete Product	DELETE	/api/invoicing/v1/products/{{productId}}	conn_mod_def::GKYtqLw681g::o8f_n5nGTM-4EHxP0wuZTg
Update Product	PUT	/api/invoicing/v1/products/{{productId}}	conn_mod_def::GKYtqhCD5Wg::yKdRzvk1RtOnmYt-m3mXDA
Update Product Stock	PUT	/api/invoicing/v1/products/{{productId}}/stock	conn_mod_def::GKYtqaDt8pg::d2ZrcMTVReeW9tvjKHKEEw

Leads

Action	Method	Path	Action id
Get Lead	GET	/api/crm/v1/leads/{{leadId}}	conn_mod_def::GKYtpevMHmA::jVcyCaoEQE2cGiwB6_lDbQ
List Leads	GET	/api/crm/v1/leads	conn_mod_def::GKYtpe1fcGA::AKhH3GpwSk6atJczEr0z6A
Create Lead	POST	/api/crm/v1/leads	conn_mod_def::GKYtpWDJGQg::l2hOepZHTa-2lk0h-EOOiw
Delete a Lead	DELETE	/api/crm/v1/leads/{{leadId}}	conn_mod_def::GKYtperf-UA::QsqXyzvyScqESWqt8pKTRQ
Update a Lead's Creation Date	PUT	/api/crm/v1/leads/{{leadId}}/dates	conn_mod_def::GKYtpoJUZ3A::qHOyoQH7Qhe57A-GZxY_yA
Update a Lead's Stage	PUT	/api/crm/v1/leads/{{leadId}}/stages	conn_mod_def::GKYtpoFYsfA::XH8uCdcASGuTO_xyjw6X4A
Update Lead	PUT	/api/crm/v1/leads/{{leadId}}	conn_mod_def::GKYtpoBnxig::_xqGXIDpSVufUscGkn2lVw

Projects

Action	Method	Path	Action id
Get a Project	GET	/api/projects/v1/projects/{{projectId}}	conn_mod_def::GKYtqo11O4A::CqHenmEWSGGAuNiVG7QMmA
Get a Project Summary	GET	/api/projects/v1/projects/{{projectId}}/summary	conn_mod_def::GKYtqo11Twg::X1eJnPx8RPy1Wsxg1NPPMQ
List Projects	GET	/api/projects/v1/projects	conn_mod_def::GKYtqpB2Ujg::G2rpW4xlS4G-T0LU3bwCUA
Create Project	POST	/api/projects/v1/projects	conn_mod_def::GKYtqaDoSWA::vMSKYq_YQgqPg__jq-Rlig
Delete Project	DELETE	/api/projects/v1/projects/{{projectId}}	conn_mod_def::GKYtqf59SZA::4iLRIaQOQm2Ts2Biwbx1MA
Update Project	PUT	/api/projects/v1/projects/{{projectId}}	conn_mod_def::GKYtqpK9QLA::7LCFkQoPRVWUlwsx1l25AA

Funnels

Action	Method	Path	Action id
Get a Funnel	GET	/api/crm/v1/funnels/{{funnelId}}	conn_mod_def::GKYtpWqA69g::L8AhZhdPSv-oMvi_WgeEWg
List Funnels	GET	/api/crm/v1/funnels	conn_mod_def::GKYtpWKCQog::1nlVGgaHRmm27O_aKJiPcQ
Create Funnel	POST	/api/crm/v1/funnels	conn_mod_def::GKYtpJ2R2Pg::aoV_wFuaRiu8AK6hELXyWg
Delete Funnel	DELETE	/api/crm/v1/funnels/{{funnelId}}	conn_mod_def::GKYtpNyxSWA::qRgA8iFUSEegow1Y0ZrkMQ
Update Funnel	PUT	/api/crm/v1/funnels/{{funnelId}}	conn_mod_def::GKYtpWp7qDA::AVMmrUZ4TJuMXFSK6LzHSA

Bookings

Action	Method	Path	Action id
Get Booking	GET	/api/crm/v1/bookings/{{bookingId}}	conn_mod_def::GKYtm59pjXg::iQ9veFSaT7SjuxbQsgdZNA
List Bookings	GET	/api/crm/v1/bookings	conn_mod_def::GKYtm5itfhg::uNblbBlvSNqytQ1DWR_ZBQ
Cancel Booking	DELETE	/api/crm/v1/bookings/{{bookingId}}	conn_mod_def::GKYtnC2gSng::XRjRolP2QRKvmRfPzvuppw
Create Booking	POST	/api/crm/v1/bookings	conn_mod_def::GKYtm5Waaeg::hlBzwPEwTfWpAvIrHv97hg
Update Booking	PUT	/api/crm/v1/bookings/{{bookingId}}	conn_mod_def::GKYtnLAbrBg::fxAnRDxGREyPIPMkm5SHFQ

ContactGroups

Action	Method	Path	Action id
Get Contact Group	GET	/api/invoicing/v1/contacts/groups/{{groupId}}	conn_mod_def::GKYtnXiS8ng::ThZwRw6-QTuhmLh5i7JNPg
List Contact Groups	GET	/api/invoicing/v1/contacts/groups	conn_mod_def::GKYtnWbwPNg::gdENc60ARzi3cbbkCAmWig
Create Contact Group	POST	/api/invoicing/v1/contacts/groups	conn_mod_def::GKYtnK23tAg::PF9wYoSkQX6Nak9m4Z2WZg
Delete Contact Group	DELETE	/api/invoicing/v1/contacts/groups/{{groupId}}	conn_mod_def::GKYtnYIDBhg::cfuNsVVNTqiom_ez5IamTQ
Update Contact Group	PUT	/api/invoicing/v1/contacts/groups/{{groupId}}	conn_mod_def::GKYtnXIVPAg::ENJdhEVOQG6p0jW_2UWZMg

Contacts

Action	Method	Path	Action id
Get Contact	GET	/api/invoicing/v1/contacts/{{contactId}}	conn_mod_def::GKYtng-eD7g::T-cAQn4JTWma-3OsXHXlow
List Contacts	GET	/api/invoicing/v1/contacts	conn_mod_def::GKYtniTy6Eg::mjQyzjthS_6eOgX4Djn53w
Create Contact	POST	/api/invoicing/v1/contacts	conn_mod_def::GKYtnXX7NIA::5ETODamsSMS3jBCCHFPpXQ
Delete Contact	DELETE	/api/invoicing/v1/contacts/{{contactId}}	conn_mod_def::GKYtngMl9Ag::JO3bcmcLTsCJZvc1yppM9A
Update Contact	PUT	/api/invoicing/v1/contacts/{{contactId}}	conn_mod_def::GKYtnq6sTtA::0ubnUV9hRmaw4GdyylJITQ

Events

Action	Method	Path	Action id
Get Event	GET	/api/crm/v1/events/{{eventId}}	conn_mod_def::GKYtpBfkhNA::8uuCPQ5iSPClvkoBWlY9Jg
List Events	GET	/api/crm/v1/events	conn_mod_def::GKYtpBtVpyA::JM37uW7LT0-FoADNOQjqLg
Create Event	POST	/api/crm/v1/events	conn_mod_def::GKYto4tOEiA::ZeQcEAUwS_-dBp_0NPqycA
Delete Event	DELETE	/api/crm/v1/events/{{eventId}}	conn_mod_def::GKYto3J4uag::OVedS7IXRhGzJR437bQrXw
Update Event	PUT	/api/crm/v1/events/{{eventId}}	conn_mod_def::GKYtpBq3hqg::KiW8OnqbReit29De9USArw

ExpensesAccounts

Action	Method	Path	Action id
Get Expenses Account	GET	/api/invoicing/v1/expensesaccounts/{{expensesAccountId}}	conn_mod_def::GKYtpJdzdOA::kyqGoHT5Qhq_w0O_XtW1GQ
List Expenses Accounts	GET	/api/invoicing/v1/expensesaccounts	conn_mod_def::GKYtpJdq2cA::6v9MwmF-SKSF6SoXTx08eg
Create Expenses Account	POST	/api/invoicing/v1/expensesaccounts	conn_mod_def::GKYtpBuMqSg::bqcnaTHWSFOjma_jbBgH8g
Delete an Expenses Account	DELETE	/api/invoicing/v1/expensesaccounts/{{expensesAccountId}}	conn_mod_def::GKYtpBhGFWA::65aKZFmeS3qKeHPLIl_Gpw
Update an Expenses Account	PUT	/api/invoicing/v1/expensesaccounts/{{expensesAccountId}}	conn_mod_def::GKYtpJ7kuuA::OIDRcG5iS0GiyZtC-AtSCw

Payments

Action	Method	Path	Action id
Get Payment	GET	/api/invoicing/v1/payments/{{paymentId}}	conn_mod_def::GKYtqB2YxFA::NVGQem8fTgicX83xLDMuKQ
List Payments	GET	/api/invoicing/v1/payments	conn_mod_def::GKYtqCwl6Qg::auh-vxtkSz2NFEi3zYiKaQ
Create Payment	POST	/api/invoicing/v1/payments	conn_mod_def::GKYtp3OotUA::M6SPjmgDTg-5ortSK_toag
Delete Payment	DELETE	/api/invoicing/v1/payments/{{paymentId}}	conn_mod_def::GKYtqAMPvLA::-zoCeA4PRVmakYAOFF_rUQ
Update Payment	PUT	/api/invoicing/v1/payments/{{paymentId}}	conn_mod_def::GKYtqCUIVNA::7LLLkuWTS4OOXszcL84LmQ

SalesChannels

Action	Method	Path	Action id
Get Sales Channel	GET	/api/invoicing/v1/saleschannels/{{salesChannelId}}	conn_mod_def::GKYtqxVaXwg::tk2IedIiRHqfHIBsECLpaQ
List Sales Channels	GET	/api/invoicing/v1/saleschannels	conn_mod_def::GKYtqxa9E7g::HG4WnkC3RhqZ2YwcqvydRw
Create Sales Channel	POST	/api/invoicing/v1/saleschannels	conn_mod_def::GKYtqxY_wbA::kaNYOXWDSwKRwgomlWqNIg
Delete Sales Channel	DELETE	/api/invoicing/v1/saleschannels/{{salesChannelId}}	conn_mod_def::GKYtqwbLF3A::XNN1ckLkQ2eIfDGnlrZMDw
Update Sales Channel	PUT	/api/invoicing/v1/saleschannels/{{salesChannelId}}	conn_mod_def::GKYtq6ob5iA::PZXwlFMhR0CWNzbUjXjVHQ

Services

Action	Method	Path	Action id
Get Service	GET	/api/invoicing/v1/services/{{serviceId}}	conn_mod_def::GKYtq5kWicA::dh04mmneTJiBahRHFeYXLg
List Services	GET	/api/invoicing/v1/services	conn_mod_def::GKYtq5scNTA::h1QlB4HrR_eAJJcolHvuYA
Create Service	POST	/api/invoicing/v1/services	conn_mod_def::GKYtq5GjlhA::jJ0FYYm5QMSMA2er7pRg1A
Delete Service	DELETE	/api/invoicing/v1/services/{{serviceId}}	conn_mod_def::GKYtq5dHDWg::v0RPuUDNRt-AQX9PXTNkYg
Update Service	PUT	/api/invoicing/v1/services/{{serviceId}}	conn_mod_def::GKYtrC-ICsg::Clu37NF4Q7K_yU-rkSAmOA

Warehouses

Action	Method	Path	Action id
Get Warehouse	GET	/api/invoicing/v1/warehouses/{{warehouseId}}	conn_mod_def::GKYtrb9RwrA::m21DSoA8Q5qJqwB1e8aUZA
List Warehouses	GET	/api/invoicing/v1/warehouses	conn_mod_def::GKYtrcZJsjA::qQH3peMkSVizVstVBBdBMw
Create Warehouse	POST	/api/invoicing/v1/warehouses	conn_mod_def::GKYtrdgIXBA::tHLqybgxQrKlvEskhixqlQ

2 more Warehouses actions are available through search.

This lists 90 of 136 actions. For anything not here, call search_one_platform_actions with platform holded. The full catalog is at https://www.withone.ai/knowledge/holded.

When a call fails

The error comes from Holded, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/holded

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.