Holded API

12 endpoints for Holded, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/holded
Connects with: Your own Holded account (a role that can use Sales and Expenses; no Developers access or API token needed)
Integration page: Holded

Read (6)

Return data and change nothing in the account.

Holded Endpoints: Read
Endpoint	Description
GET /contacts	Contacts with name, type, email and tax ID, newest first. Search by name, email or tax ID.
GET /contacts/{contact_id}	One contact with email, tax ID, type and tags.
GET /invoices	Sales invoices with number, client, total, due date and payment status, oldest due date first.
GET /invoices/{invoice_id}	One invoice with lines, taxes, total, payments and approval state.
GET /purchases	Purchase invoices (expenses) with supplier, supplier document number, total and due date, newest first.
GET /products	Products and services you can put on a line, with name, price and tax.

Change the account. Calls marked Confirm wait for the user to approve them.

Holded Endpoints: Write
Endpoint	Description
POST /contacts	Add a customer, supplier or lead to Holded.
PATCH /contacts/{contact_id}	Change a contact's name, type, email or tax ID.
POST /contacts/{contact_id}/invoices Confirm	Create a sales invoice as a draft, or approve it right away.
POST /invoices/{invoice_id} Confirm	Email an invoice to a recipient from Holded, with a link to the customer portal.
POST /invoices/{invoice_id}/payment Confirm	Record a payment received on an invoice, in full or in part.
POST /contacts/{contact_id}/purchases Confirm	Record a supplier bill as a purchase, as a draft or approved.