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

# Holded

> Holded is business management software for managing sales documents, invoices, services, contacts, contact groups, and tags.

![Holded logo](https://mintcdn.com/composio-preview/o1IUBrrsmtgkhmyf/images/toolkits/holded.svg?fit=max\&auto=format\&n=o1IUBrrsmtgkhmyf\&q=85\&s=3568388601a4eb04da738fa49aae293c)

* **Category:** sales & crm
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `HOLDED`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Contact
>
> **Slug:** `HOLDED_CREATE_CONTACT`
>
> Create a customer, supplier, lead, debtor, creditor, or unclassified contact and return its new Holded ID.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Full name of the person or legal name of the company.
>
> **email** `string`
>
> Primary email address.
>
> **phone** `string`
>
> Landline phone number.
>
> **mobile** `string`
>
> Mobile phone number.
>
> **tax\_id** `string`
>
> Tax identification number, such as NIF or CIF.
>
> **website** `string`
>
> Contact website URL.
>
> **is\_person** `boolean`
>
> True for an individual person; false for a company.
>
> **trade\_name** `string`
>
> Commercial name when different from the legal name.
>
> **vat\_number** `string`
>
> EU VAT number for intra-community operations.
>
> **contact\_type** `string ("client" | "debtor" | "supplier" | "creditor" | "lead")`
>
> How Holded classifies the contact; omit to leave it unclassified.
>
> **billing\_address** `object`
>
> Billing address for the 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] Create Invoice
>
> **Slug:** `HOLDED_CREATE_INVOICE`
>
> Create a sales invoice for an existing contact and return its ID; this does not send, approve, or record payment for the invoice.
>
> #### Input Parameters
>
> **body** `string`
>
> Rich-text content printed on the invoice.
>
> **tags** `array`
>
> Existing Holded tags to attach to the invoice.
>
> **items** `array` *required*
>
> Invoice lines. Provide at least one priced product or service line for a billable invoice.
>
> **notes** `string`
>
> Internal notes visible only to the Holded team.
>
> **currency** `string`
>
> ISO 4217 currency code, such as EUR.
>
> **discount** `number`
>
> Global invoice discount percentage.
>
> **due\_date** `string`
>
> Payment due date as YYYY-MM-DD or an RFC 3339 date-time.
>
> **language** `string`
>
> ISO 639-1 invoice language code, such as es or en.
>
> **contact\_id** `string` *required*
>
> Existing Holded contact ID for the customer.
>
> **issue\_date** `string`
>
> Issue date as YYYY-MM-DD or an RFC 3339 date-time; omit to use Holded's default.
>
> **description** `string`
>
> Short free-text invoice description.
>
> **currency\_change** `number`
>
> Exchange rate when currency differs from the account currency.
>
> **sales\_channel\_id** `string`
>
> Existing Holded sales-channel ID.
>
> **numbering\_series\_id** `string`
>
> Existing invoice numbering-series ID to control document numbering.
>
> #### 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:** `HOLDED_DELETE_CONTACT`
>
> Permanently delete one contact by ID; linked documents keep display text but lose the live contact association.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> Holded contact ID to permanently delete, a 24-character lowercase hexadecimal string. Use this for a fixture you created or a contact the user explicitly selected.
>
> #### 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 Invoice
>
> **Slug:** `HOLDED_DELETE_INVOICE`
>
> Permanently delete one invoice and its recorded payments; its document number is not reused.
>
> #### Input Parameters
>
> **invoice\_id** `string` *required*
>
> Holded invoice ID to permanently delete, a 24-character lowercase hexadecimal string. Use this for a fixture you created or an invoice the user explicitly selected.
>
> #### 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] Find Contacts
>
> **Slug:** `HOLDED_FIND_CONTACTS`
>
> Find Holded contacts by name prefix or by email, phone, mobile, tax ID, or external ID; name cannot be combined with the other filters. With no filter, return one page of contacts.
>
> #### Input Parameters
>
> **name** `string`
>
> Contact name prefix to search, case- and diacritic-insensitively. Cannot be combined with exact-match filters.
>
> **email** `string`
>
> Exact primary email address to match.
>
> **limit** `integer`
>
> Maximum contacts to return in this page (1-200).
>
> **phone** `string`
>
> Exact landline phone number to match.
>
> **cursor** `string`
>
> Opaque cursor returned by the previous call. Repeat the same search filters when continuing; omit for the first page.
>
> **mobile** `string`
>
> Exact mobile phone number to match.
>
> **tax\_id** `string`
>
> Exact tax identification number, such as NIF or CIF, to match.
>
> **external\_id** `string`
>
> Exact caller-defined external contact identifier to match.
>
> #### 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] Find Invoices
>
> **Slug:** `HOLDED_FIND_INVOICES`
>
> Find Holded invoices by document-number prefix or list them by contact, payment status, issue date, or due date; document-number searches cannot be combined with those filters or sorting. With no filter, return one page of invoices.
>
> #### Input Parameters
>
> **sort** `string ("date" | "-date" | "dueDate" | "-dueDate" | "total" | "-total")`
>
> Sort field; a leading minus means descending.
>
> **limit** `integer`
>
> Maximum invoices to return in this page (1-200).
>
> **cursor** `string`
>
> Opaque cursor returned by the previous call. Repeat the same search filters when continuing; omit for the first page.
>
> **status** `string ("pending" | "completed" | "partial" | "cancelled" | "failed" | "overdue")`
>
> Payment status. Pending excludes partially paid invoices; query partial separately when calculating all outstanding receivables. Overdue includes unpaid or partially paid invoices past due.
>
> **contact\_id** `string`
>
> Filter by the exact Holded contact ID.
>
> **due\_date\_end** `string`
>
> Latest due date, as YYYY-MM-DD or an RFC 3339 date-time.
>
> **due\_date\_start** `string`
>
> Earliest due date, as YYYY-MM-DD or an RFC 3339 date-time.
>
> **issue\_date\_end** `string`
>
> Latest issue date, as YYYY-MM-DD or an RFC 3339 date-time.
>
> **document\_number** `string`
>
> Fuzzy document-number prefix; minor typos are tolerated. Draft, deleted, and cancelled invoices are excluded from this search route. Cannot be combined with contact, status, date, due-date, or sort filters.
>
> **issue\_date\_start** `string`
>
> Earliest issue date, as YYYY-MM-DD or an RFC 3339 date-time.
>
> #### 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:** `HOLDED_GET_CONTACT`
>
> Return the complete profile of one contact by its Holded contact ID.
>
> #### Input Parameters
>
> **contact\_id** `string` *required*
>
> Holded contact ID, a 24-character lowercase hexadecimal string.
>
> #### 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 Invoice
>
> **Slug:** `HOLDED_GET_INVOICE`
>
> Return full details, lines, totals, and payment summary for one invoice by its Holded ID.
>
> #### Input Parameters
>
> **invoice\_id** `string` *required*
>
> Holded invoice ID, a 24-character lowercase hexadecimal string.
>
> #### 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:** `HOLDED_UPDATE_CONTACT`
>
> Safely change selected fields on a contact without clearing unspecified profile data. Reads the contact before updating and returns the verified result.
>
> #### Input Parameters
>
> **changes** `object` *required*
>
> Fields to change. Omitted fields remain unchanged; an explicit null clears a nullable field.
>
> **contact\_id** `string` *required*
>
> Holded contact ID, a 24-character lowercase hexadecimal string.
>
> #### 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 Invoice
>
> **Slug:** `HOLDED_UPDATE_INVOICE`
>
> Change selected mutable fields on an invoice, reading it before updating and returning the verified result. Supplying items replaces the complete invoice line array.
>
> #### Input Parameters
>
> **changes** `object` *required*
>
> Invoice fields to change. Omitted fields remain unchanged; an explicit null clears a nullable field.
>
> **invoice\_id** `string` *required*
>
> Holded invoice ID, a 24-character lowercase hexadecimal string.
>
> #### 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
