Faktoora integration
Faktoora is a German e-invoicing service compliant with the European standard EN16931. Create XRechnung, ZUGFeRD or Peppol invoices from structured data, track their generation and delivery status, mark them paid, read the parsed content of incoming and outgoing e-invoices, accept or reject incoming ones, and manage customers, products, product bundles, projects, metadata templates, invoice number templates and webhook subscriptions. File downloads (PDF, XML, attachments), multipart e-invoice uploads, the legacy generic import routes and the per-section content routes (seller, buyer, delivery, payment) are not exposed: the full content route returns those sections. Authentication is an API key generated in the Faktoora account settings, sent in the X-API-KEY header.
Say what should happen.
The workflow builds itself.
What you can do with Faktoora
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.
Attachment, 6 operations
get_incoming_invoice_attachmentGet incoming invoice attachmentGETRetrieve metadata for a specific attachment associated with an invoice importget_invoice_attachmentGet invoice attachmentGETSame handler as `get_outgoing_import_attachment`.get_outgoing_import_attachmentGet outgoing import attachmentGETRetrieve metadata for a specific attachment associated with an invoice importlist_incoming_invoice_attachmentsList incoming invoice attachmentsGETRetrieve a paginated list of attachments associated with a specific invoice importlist_invoice_attachmentsList invoice attachmentsGETReturns a paginated list of integrated files extracted from the invoice. Same handler as `list_outgoing_import_attachments`.list_outgoing_import_attachmentsList outgoing import attachmentsGETRetrieve a paginated list of attachments associated with a specific invoice import
Metadata template, 5 operations
create_metadata_templateCreate metadata templatePOSTCreates a new metadata template. Field keys are auto-generated if omitted.delete_metadata_templateDelete metadata templateDELETEDeletes a metadata template. Only inactive templates can be deleted.get_metadata_templateGet metadata templateGETReturns the full template including fields with options.list_metadata_templatesList metadata templatesGETReturns a paginated list of metadata templates. The response excludes the full fields array, use the detail endpoint for that. Unknown query parameters return 400.update_metadata_templateUpdate metadata templatePATCHPartial update, send only the fields you want to change. Omitted fields are preserved. When fields is sent, the field list is replaced in full. Existing field keys are preserved.
Project, 5 operations
create_projectCreate projectPOSTCreates a new project for the authenticated user.delete_projectDelete projectDELETEDeletes a project by ID. Any document assignments linked to the project are also removed so that documents can be freely re-assigned afterward.get_projectGet projectGETReturns a single project by ID.list_projectsList projectsGETReturns a paginated list of projects for the authenticated user. Unknown query parameters return 400.update_projectUpdate projectPATCHUpdates one or more fields of an existing project. All body fields are optional.
Webhook, 4 operations
create_webhookCreate webhookPOSTCreate a new webhook subscription to receive notifications for specific events (e.g., invoice creation).delete_webhookDelete webhookDELETEDelete webhook subscriptions for a userlist_webhooksList webhooksGETReturns a paginated list of webhook subscriptions created by the user. Unknown query parameters return 400.update_webhookUpdate webhookPATCHUpdate webhook subscriptions for a user
Content, 3 operations
get_incoming_invoice_contentGet incoming invoice contentGETRetrieve merged data from seller, buyer, lineitems, taxes, paymentterms, and paymentmeans endpointsget_invoice_contentGet invoice contentGETMerged data from seller, buyer, invoicee, lineitems, taxes, paymentterms, and paymentmeans. Same handler as `get_outgoing_import_content`.get_outgoing_import_contentGet outgoing import contentGETRetrieve merged data from seller, buyer, invoicee, lineitems, taxes, paymentterms, and paymentmeans endpoints
Customer, 3 operations
delete_customerDelete customerDELETEDeletes one customer of the account by its id, as returned by list_customers.get_customerGet customerGETGet customers of current user by Idlist_customersList customersGETReturns a paginated list of customers for the authenticated user. Unknown query parameters return 400.
Invoice, 3 operations
create_invoiceCreate invoicePOSTCreates one or more e-invoices (XRechnung, ZUGFeRD, Peppol and other formats) from structured data. Asynchronous: returns a faktooraId at once; poll get_invoice_status, then read get_invoice_content.delete_invoiceDelete invoiceDELETEDelete an invoice referenced via faktooraId. `invoiceDeleteMode` must be enabled in order to do this action.list_invoicesList invoicesGETReturns a paginated list of all current invoices with filtering, sorting, and search capabilities. Unknown query parameters return 400.
Lineitem, 3 operations
list_incoming_invoice_line_itemsList incoming invoice line itemsGETthis endpoint returns a list of line items the incoming imported invoicelist_invoice_line_itemsList invoice line itemsGETSame handler as `list_outgoing_import_line_items`.list_outgoing_import_line_itemsList outgoing import line itemsGETthis endpoint returns a list of line items the outgoing imported invoice
Product, 3 operations
delete_productDelete productDELETEDeletes one product of the account by its id, as returned by list_products.get_productGet productGETGet product by id for current userlist_productsList productsGETReturns a paginated list of products for the authenticated user. Unknown query parameters return 400.
Productbundle, 3 operations
delete_product_bundleDelete product bundleDELETEDeletes one product bundle of the account by its id, as returned by list_product_bundles.get_product_bundleGet product bundleGETGet product bundle by id for current userlist_product_bundlesList product bundlesGETReturns a paginated list of product bundles for the authenticated user. Unknown query parameters return 400.
Status, 3 operations
get_incoming_import_statusGet incoming import statusGETReturns the processing status of an incoming import (not of the invoice itself): validationStatus, visualizationStatus and overallStatus. Wait until overallStatus is no longer pending.get_invoice_statusGet invoice statusGETReturns the current status of invoice processing including authority registration, delivery information, and job completion status.get_outgoing_import_statusGet outgoing import statusGETReturns the processing status of an outgoing import (not of the invoice itself): validationStatus, visualizationStatus and overallStatus. Wait until overallStatus is no longer pending.
Summary, 3 operations
get_incoming_invoice_summaryGet incoming invoice summaryGETthis endpoint returns the most important attributes of the incoming imported invoiceget_invoice_summaryGet invoice summaryGETReturns the most important attributes of the invoice. Same handler as `get_outgoing_import_summary`.get_outgoing_import_summaryGet outgoing import summaryGETReturns the most important attributes of an outgoing imported invoice, including detailsPage (its link in the Faktoora app). An import still processing answers 404: check get_outgoing_import_status first.
Tax, 3 operations
list_incoming_invoice_taxesList incoming invoice taxesGETThis endpoint returns detailed taxes information information for the incoming imported invoice, including taxable amounts, VAT rates, exemption details, and calculated tax amounts.list_invoice_taxesList invoice taxesGETSame handler as `list_outgoing_import_taxes`.list_outgoing_import_taxesList outgoing import taxesGETThis endpoint returns detailed taxes information for the outgoing imported invoice, including taxable amounts, VAT rates, exemption details, and calculated tax amounts.
Validation, 3 operations
get_incoming_invoice_validationGet incoming invoice validationGETReturns the validation verdict for an incoming imported invoice: `accepted`, `rejected`, `pending` while the import is still being processed.get_invoice_validationGet invoice validationGETValidation verdict of the invoice.get_outgoing_import_validationGet outgoing import validationGETReturns the import-time validation verdict of an outgoing imported e-invoice: accepted (valid, warnings do not count) or rejected (validation errors). The invoice is imported whatever the verdict.
Incoming, 2 operations
list_incoming_invoicesList incoming invoicesGETLists incoming imported e-invoices (paginated, filterable by keyword and dates). An upload appears here only once parsing has produced a record.update_incoming_invoiceUpdate incoming invoicePATCHPartially update editable fields of an incoming imported invoice. Only the fields listed in the request body schema are accepted.
Invoice number template, 2 operations
get_invoice_number_templateGet invoice number templateGETReturns the configured template, pad length, and current counter value.update_invoice_number_templateUpdate invoice number templatePUTUpdates the template and/or pad length. At least one field must be provided. Requires permission to manage invoice numbering.
Mark paid, 2 operations
mark_incoming_invoice_paidMark incoming invoice paidPOSTMarks an incoming (received) invoice as paid. For an invoice received through the French PA channel, Faktoora also sends a payment report on a best-effort basis.mark_invoice_paidMark invoice paidPOSTMarks the invoice as paid, recording a payment of `amount` on `paymentDate`.
Accept, 1 operation
accept_incoming_invoiceAccept incoming invoicePOSTAccepts the invoice (buyer decision). The invoice must currently be in `created` status.
Document, 1 operation
link_document_to_projectLink document to projectPOSTLinks a document (invoice, offer, letter, etc.) to a project. **Constraints:** - Each project can hold at most **one** linked document.
Generate number, 1 operation
generate_customer_numberGenerate customer numberGETGenerate customer number base on current counting
Import, 1 operation
import_customersImport customersPOSTValidates (dryRun true) or imports up to 1000 customers in one call; each entry carries a line number from your source and a customer object.
Invoice status, 1 operation
get_incoming_invoice_decision_statusGet incoming invoice decision statusGETReturns the buyer-decision status of the invoice and, for a france-pa-sourced invoice, the dispatch status of any FR_FLOW6 status/payment report sent to the PDP (Invopop).
Next number, 1 operation
get_next_invoice_numberGet next invoice numberGETReturns the next invoice number based on the current counter and optional template.
Option, 1 operation
search_metadata_field_optionsSearch metadata field optionsGETSearches the options of a select field of a metadata template by substring match on value and label.
Outgoing, 1 operation
list_outgoing_importsList outgoing importsGETReturns a paginated list of all outgoing imported invoices with filtering, sorting, and search capabilities.
Pause, 1 operation
pause_peppol_deliveryPause peppol deliveryPOSTSuspends the Peppol delivery of an invoice before its next transmission attempt.
Recurring invoice, 1 operation
list_recurring_invoicesList recurring invoicesGETReturns a paginated list of recurring invoice schedules for the authenticated user. Unknown query parameters return 400.
Reject, 1 operation
reject_incoming_invoiceReject incoming invoicePOSTRejects the invoice (buyer decision). The invoice must currently be in `created` status.
Resend, 1 operation
resend_peppol_deliveryResend peppol deliveryPOSTResumes the Peppol delivery of an invoice that gave up after exhausting its retries (delivery state SUSPENDED) and republishes it to the Peppol network.
Valid code, 1 operation
verify_product_codeVerify product codeGETChecks whether a product code is valid and still available for a new product.
Verify customer number, 1 operation
verify_customer_numberVerify customer numberGETChecks whether a customer number is still available for a new customer before you use it.
Verify number, 1 operation
verify_invoice_numberVerify invoice numberGETChecks if the given invoice number is already in use. Draft and temporary invoices are excluded. Unknown query parameters return 400.
Use Faktoora from Claude Code, Cursor or Codex
Connect Faktoora in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Faktoora 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 Faktoora
- Create your workspace
Sign up free. Nothing to install.
- Connect Faktoora once
Add your Faktoora 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.
Faktoora integration FAQ
What can you do with the Faktoora integration?
LiveContext exposes 71 operations on Faktoora, covering attachment, metadata template, project and webhook.
