Alegra integration
Alegra is a cloud accounting, invoicing and inventory service for small businesses in Latin America and Spain. Create, edit, email, void and reopen sales invoices; record payments received and made and void them; create estimates and email them; create credit notes and purchase bills; manage contacts (clients and providers) and products and services; and read taxes, retentions, payment terms, warehouses, price lists, numberings, bank accounts, item and cost-center lists, currencies, users and the company. Webhook subscriptions notify a URL when an invoice, bill, client or item is created, edited or deleted. Lists return 30 records at most per call (start and limit). Ids are strings. Country-specific electronic invoicing fields beyond those named, attachments, remissions, recurring documents, purchase orders, inventory adjustments, accounting journals and bank reconciliations are not offered. Authentication is HTTP Basic with the user email and the API token from Alegra settings (API, integrations with other systems); the API allows 150 requests per minute per user.
Say what should happen.
The workflow builds itself.
What you can do with Alegra
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Contact, 5 operations
create_contactCreate contactPOSTCreates a contact (client, provider or both) with its name, identification, email, phones and address.delete_contactDelete contactDELETEDeletes a contact.get_contactGet contactGETReturns one contact with its identification, emails and phones, address, seller, payment term, price list, credit limit and internal contacts.list_contactsList contactsGETLists contacts (clients and providers), 30 at most per call (start, limit), searchable by name or identification and filterable by type client or provider.update_contactUpdate contactPUTEdits a contact; send the attributes to change.
Invoice, 5 operations
create_invoiceCreate invoicePOSTCreates a sales invoice for a client with its items (id, price, quantity). It is created as draft unless status is open or payments are attached; numberTemplate picks the numbering.delete_invoiceDelete invoiceDELETEDeletes a sales invoice that is still a draft.get_invoiceGet invoiceGETReturns one sales invoice with its client, items, taxes, retentions, payments and totals; fields=pdf adds the PDF link and fields=xml the stamped XML link.list_invoicesList invoicesGETLists sales invoices, 30 at most per call (start, limit), filterable by status (open, closed, draft, void), client, number, item and date or due date, exact or before or after a day.update_invoiceUpdate invoicePUTEdits a sales invoice: only the attributes sent change, the others stay as they are. Returns the invoice.
Item, 5 operations
create_itemCreate itemPOSTCreates a product or service with its name, price, taxes and, for an inventoried product, its unit and initial stock per warehouse.delete_itemDelete itemDELETEDeletes a product or service.get_itemGet itemGETReturns one product or service with its prices per price list, taxes, category and inventory per warehouse.list_itemsList itemsGETLists products and services, 30 at most per call (start, limit), searchable by name or reference and filterable by warehouse, item category, price list, status or inventoried.update_itemUpdate itemPUTEdits a product or service; send the attributes to change. An inactive item can only be edited if status active is sent with the change.
Subscription, 5 operations
create_webhook_subscriptionCreate webhook subscriptionPOSTSubscribes a URL to an event (new, edited or deleted invoice, bill, client or item). Alegra POSTs an empty body to the URL first, which must answer 2xx within 5 seconds.delete_webhook_subscriptionDelete webhook subscriptionDELETEDeletes a webhook subscription.get_webhook_subscriptionGet webhook subscriptionGETReturns one webhook subscription: its event and URL.list_webhook_subscriptionsList webhook subscriptionsGETLists the webhook subscriptions of the company.update_webhook_subscriptionUpdate webhook subscriptionPUTChanges the URL of a webhook subscription.
Payment, 4 operations
create_paymentCreate paymentPOSTRecords a payment into or out of a bank account, applied to sales invoices (invoices), purchase bills (bills) or accounting categories (categories, with type in or out).delete_paymentDelete paymentDELETEDeletes a payment received or made.get_paymentGet paymentGETReturns one payment with its bank account, client, the invoices it paid and the amounts.list_paymentsList paymentsGETLists payments received (type in) and made (type out), 30 at most per call (start, limit), filterable by client or by ids.
Bill, 3 operations
create_billCreate billPOSTRecords a purchase bill from a provider, with the items and accounting categories purchased.get_billGet billGETReturns one purchase bill with its provider, purchased items and categories, payments and totals.list_billsList billsGETLists purchase bills (provider invoices), 30 at most per call (start, limit), filterable by number, provider, status (open, closed, void) and date.
Credit note, 3 operations
create_credit_noteCreate credit notePOSTCreates a credit note for a client, with its items, the sales invoices it applies to (invoices) or the refunds paid out (refunds).get_credit_noteGet credit noteGETReturns one credit note with its client, items, the invoices it was applied to and its totals.list_credit_notesList credit notesGETLists credit notes, 30 at most per call (start, limit), filterable by client, item, number and date.
Estimate, 3 operations
create_estimateCreate estimatePOSTCreates an estimate (quote) for a client with its items, date and due date.get_estimateGet estimateGETReturns one estimate (quote) with its client, items and totals.list_estimatesList estimatesGETLists estimates (quotes), 30 at most per call (start, limit), filterable by client, item, number and date.
Email, 2 operations
send_estimate_emailSend estimate emailPOSTEmails an estimate (quote) to one or more addresses.send_invoice_emailSend invoice emailPOSTEmails a sales invoice to one or more addresses, as the original or as a copy, optionally with a copy to the user making the call.
Void, 2 operations
void_invoiceVoid invoicePOSTVoids (annuls) a sales invoice, optionally with the cause.void_paymentVoid paymentPOSTVoids a payment: it stays on record but no longer affects the accounting or the reports.
Bank account, 1 operation
list_bank_accountsList bank accountsGETLists bank, cash and other money accounts, whose ids payments take as bankAccount; includeBalance adds their balances.
Company, 1 operation
get_companyGet companyGETReturns the company of the Alegra account: name, identification, regime, address, currency, time zone and decimal precision.
Cost center, 1 operation
list_cost_centersList cost centersGETLists cost centers, 30 at most per call (start, limit), filterable by name and status.
Currency, 1 operation
list_currenciesList currenciesGETLists the currencies enabled in the company with their exchange rates (multi-currency).
Item category, 1 operation
list_item_categoriesList item categoriesGETLists item categories, 30 at most per call (start, limit), filterable by name, description and status.
Number template, 1 operation
list_number_templatesList number templatesGETLists the document numberings (prefix, next number, default) for one document type: invoice, estimate, transactionIn, transactionOut, creditNote, debitNote or incomeDebitNote.
Open, 1 operation
reopen_invoiceReopen invoicePOSTReverts the voiding of a sales invoice, making it open again; without stamp the invoice is reopened without being stamped.
Price list, 1 operation
list_price_listsList price listsGETLists the price lists of the company, searchable by name.
Retention, 1 operation
list_retentionsList retentionsGETLists the withholding taxes (retentions) configured in the company, whose ids invoices and payments take in retentions.
Self, 1 operation
get_current_userGet current userGETReturns the user the API credentials belong to.
Tax, 1 operation
list_taxesList taxesGETLists the taxes configured in the company (id, name, percentage, type), whose ids items and invoice lines take as tax.
Term, 1 operation
list_payment_termsList payment termsGETLists the payment terms (name and days) configured in the company, whose ids contacts take as term.
User, 1 operation
list_usersList usersGETLists the users of the Alegra account with their role and status.
Warehouse, 1 operation
list_warehousesList warehousesGETLists warehouses, 30 at most per call (start, limit), filterable by name and status.
Use Alegra from Claude Code, Cursor or Codex
Connect Alegra in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Alegra operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Alegra
- Create your workspace
Sign up free. Nothing to install.
- Connect Alegra once
Add your Alegra connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Alegra integration FAQ
What can you do with the Alegra integration?
LiveContext exposes 51 operations on Alegra, covering contact, invoice, item and subscription.
