Skip to main content
Holded logo
  • Category: sales & crm
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: HOLDED
  • Version: 20261101_00

Tools

Slug: HOLDED_CREATE_CONTACTCreate a customer, supplier, lead, debtor, creditor, or unclassified contact and return its new Holded ID.

Input Parameters

string
required
Full name of the person or legal name of the company.
string
Primary email address.
string
Landline phone number.
string
Mobile phone number.
string
Tax identification number, such as NIF or CIF.
string
Contact website URL.
boolean
True for an individual person; false for a company.
string
Commercial name when different from the legal name.
string
EU VAT number for intra-community operations.
string ("client" | "debtor" | "supplier" | "creditor" | "lead")
How Holded classifies the contact; omit to leave it unclassified.
object
Billing address for the 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: HOLDED_CREATE_INVOICECreate a sales invoice for an existing contact and return its ID; this does not send, approve, or record payment for the invoice.

Input Parameters

string
Rich-text content printed on the invoice.
array
Existing Holded tags to attach to the invoice.
array
required
Invoice lines. Provide at least one priced product or service line for a billable invoice.
string
Internal notes visible only to the Holded team.
string
ISO 4217 currency code, such as EUR.
number
Global invoice discount percentage.
string
Payment due date as YYYY-MM-DD or an RFC 3339 date-time.
string
ISO 639-1 invoice language code, such as es or en.
string
required
Existing Holded contact ID for the customer.
string
Issue date as YYYY-MM-DD or an RFC 3339 date-time; omit to use Holded’s default.
string
Short free-text invoice description.
number
Exchange rate when currency differs from the account currency.
string
Existing Holded sales-channel ID.
string
Existing invoice numbering-series ID to control document numbering.

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: HOLDED_DELETE_CONTACTPermanently delete one contact by ID; linked documents keep display text but lose the live contact association.

Input Parameters

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

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: HOLDED_DELETE_INVOICEPermanently delete one invoice and its recorded payments; its document number is not reused.

Input Parameters

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

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: HOLDED_FIND_CONTACTSFind 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

string
Contact name prefix to search, case- and diacritic-insensitively. Cannot be combined with exact-match filters.
string
Exact primary email address to match.
integer
Maximum contacts to return in this page (1-200).
string
Exact landline phone number to match.
string
Opaque cursor returned by the previous call. Repeat the same search filters when continuing; omit for the first page.
string
Exact mobile phone number to match.
string
Exact tax identification number, such as NIF or CIF, to match.
string
Exact caller-defined external contact identifier to match.

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: HOLDED_FIND_INVOICESFind 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

string ("date" | "-date" | "dueDate" | "-dueDate" | "total" | "-total")
Sort field; a leading minus means descending.
integer
Maximum invoices to return in this page (1-200).
string
Opaque cursor returned by the previous call. Repeat the same search filters when continuing; omit for the first page.
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.
string
Filter by the exact Holded contact ID.
string
Latest due date, as YYYY-MM-DD or an RFC 3339 date-time.
string
Earliest due date, as YYYY-MM-DD or an RFC 3339 date-time.
string
Latest issue date, as YYYY-MM-DD or an RFC 3339 date-time.
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.
string
Earliest issue date, as YYYY-MM-DD or an RFC 3339 date-time.

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: HOLDED_GET_CONTACTReturn the complete profile of one contact by its Holded contact ID.

Input Parameters

string
required
Holded contact ID, a 24-character lowercase hexadecimal string.

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: HOLDED_GET_INVOICEReturn full details, lines, totals, and payment summary for one invoice by its Holded ID.

Input Parameters

string
required
Holded invoice ID, a 24-character lowercase hexadecimal string.

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: HOLDED_UPDATE_CONTACTSafely change selected fields on a contact without clearing unspecified profile data. Reads the contact before updating and returns the verified result.

Input Parameters

object
required
Fields to change. Omitted fields remain unchanged; an explicit null clears a nullable field.
string
required
Holded contact ID, a 24-character lowercase hexadecimal string.

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: HOLDED_UPDATE_INVOICEChange 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

object
required
Invoice fields to change. Omitted fields remain unchanged; an explicit null clears a nullable field.
string
required
Holded invoice ID, a 24-character lowercase hexadecimal string.

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