ERPNext
Customers, suppliers, items, sales and purchase documents, stock entries, projects, tasks, employees and CRM records through the Frappe REST API.
Keep ERPNext master data and draft transactions in step with commerce, CRM and project systems without custom scripts.
Source actions
35
Destination actions
31
Data types
18
Validation status
Implemented · fixture tested.
Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.
What you can map
customers
- Create customerDestinationNot retried automaticallyApproval before production
Creates a draft Customer. Submission and cancellation stay in ERPNext.
customers.create - Get customerSource
Reads one Customer with child tables and custom fields.
customers.get - List customersSourceIncremental
Lists ERPNext Customer documents by modification time.
customers.list - Update customerDestinationProvider duplicate protectionApproval before production
Updates fields of a Customer; submitted documents only accept fields allowed on submit.
customers.update
delivery notes
- Create delivery noteDestinationNot retried automaticallyApproval before production
Creates a draft Delivery Note. Submission and cancellation stay in ERPNext.
delivery_notes.create - Get delivery noteSource
Reads one Delivery Note with child tables and custom fields.
delivery_notes.get - List delivery notesSourceIncremental
Lists ERPNext Delivery Note documents by modification time.
delivery_notes.list - Update delivery noteDestinationProvider duplicate protectionApproval before production
Updates fields of a Delivery Note; submitted documents only accept fields allowed on submit.
delivery_notes.update
documents
- Create documentDestinationNot retried automaticallyApproval before production
Creates a draft document of an allow-listed DocType. docstatus is always 0 (draft); submission is not available.
documents.create - Get documentSource
Reads one document of an allow-listed DocType with child tables.
documents.get - List documents of a DocTypeSourceIncremental
Lists documents of an allow-listed DocType with all parent fields.
documents.list - Update documentDestinationProvider duplicate protectionApproval before production
Updates fields of a document of an allow-listed DocType (not Stock Entry). docstatus cannot be changed.
documents.update
employees
- Create employeeDestinationNot retried automaticallyApproval before production
Creates a draft Employee. Submission and cancellation stay in ERPNext.
employees.create - Get employeeSource
Reads one Employee with child tables and custom fields.
employees.get - List employeesSourceIncremental
Lists ERPNext Employee documents by modification time.
employees.list - Update employeeDestinationProvider duplicate protectionApproval before production
Updates fields of a Employee; submitted documents only accept fields allowed on submit.
employees.update
items
- Create itemDestinationNot retried automaticallyApproval before production
Creates a draft Item. Submission and cancellation stay in ERPNext.
items.create - Get itemSource
Reads one Item with child tables and custom fields.
items.get - List itemsSourceIncremental
Lists ERPNext Item documents by modification time.
items.list - Update itemDestinationProvider duplicate protectionApproval before production
Updates fields of a Item; submitted documents only accept fields allowed on submit.
items.update
leads
- Create leadDestinationNot retried automaticallyApproval before production
Creates a draft Lead. Submission and cancellation stay in ERPNext.
leads.create - Get leadSource
Reads one Lead with child tables and custom fields.
leads.get - List leadsSourceIncremental
Lists ERPNext Lead documents by modification time.
leads.list - Update leadDestinationProvider duplicate protectionApproval before production
Updates fields of a Lead; submitted documents only accept fields allowed on submit.
leads.update
opportunities
- Create opportunityDestinationNot retried automaticallyApproval before production
Creates a draft Opportunity. Submission and cancellation stay in ERPNext.
opportunities.create - Get opportunitySource
Reads one Opportunity with child tables and custom fields.
opportunities.get - List opportunitysSourceIncremental
Lists ERPNext Opportunity documents by modification time.
opportunities.list - Update opportunityDestinationProvider duplicate protectionApproval before production
Updates fields of a Opportunity; submitted documents only accept fields allowed on submit.
opportunities.update
payment entries
- Get payment entrySource
Reads one Payment Entry with child tables and custom fields.
payment_entries.get - List payment entrysSourceIncremental
Lists ERPNext Payment Entry documents by modification time.
payment_entries.list
projects
- Create projectDestinationNot retried automaticallyApproval before production
Creates a draft Project. Submission and cancellation stay in ERPNext.
projects.create - Get projectSource
Reads one Project with child tables and custom fields.
projects.get - List projectsSourceIncremental
Lists ERPNext Project documents by modification time.
projects.list - Update projectDestinationProvider duplicate protectionApproval before production
Updates fields of a Project; submitted documents only accept fields allowed on submit.
projects.update
purchase invoices
- Create purchase invoiceDestinationNot retried automaticallyApproval before production
Creates a draft Purchase Invoice. Submission and cancellation stay in ERPNext.
purchase_invoices.create - Get purchase invoiceSource
Reads one Purchase Invoice with child tables and custom fields.
purchase_invoices.get - List purchase invoicesSourceIncremental
Lists ERPNext Purchase Invoice documents by modification time.
purchase_invoices.list - Update purchase invoiceDestinationProvider duplicate protectionApproval before production
Updates fields of a Purchase Invoice; submitted documents only accept fields allowed on submit.
purchase_invoices.update
purchase orders
- Create purchase orderDestinationNot retried automaticallyApproval before production
Creates a draft Purchase Order. Submission and cancellation stay in ERPNext.
purchase_orders.create - Get purchase orderSource
Reads one Purchase Order with child tables and custom fields.
purchase_orders.get - List purchase ordersSourceIncremental
Lists ERPNext Purchase Order documents by modification time.
purchase_orders.list - Update purchase orderDestinationProvider duplicate protectionApproval before production
Updates fields of a Purchase Order; submitted documents only accept fields allowed on submit.
purchase_orders.update
quotations
- Create quotationDestinationNot retried automaticallyApproval before production
Creates a draft Quotation. Submission and cancellation stay in ERPNext.
quotations.create - Get quotationSource
Reads one Quotation with child tables and custom fields.
quotations.get - List quotationsSourceIncremental
Lists ERPNext Quotation documents by modification time.
quotations.list - Update quotationDestinationProvider duplicate protectionApproval before production
Updates fields of a Quotation; submitted documents only accept fields allowed on submit.
quotations.update
sales invoices
- Create sales invoiceDestinationNot retried automaticallyApproval before production
Creates a draft Sales Invoice. Submission and cancellation stay in ERPNext.
sales_invoices.create - Get sales invoiceSource
Reads one Sales Invoice with child tables and custom fields.
sales_invoices.get - List sales invoicesSourceIncremental
Lists ERPNext Sales Invoice documents by modification time.
sales_invoices.list - Update sales invoiceDestinationProvider duplicate protectionApproval before production
Updates fields of a Sales Invoice; submitted documents only accept fields allowed on submit.
sales_invoices.update
sales orders
- Create sales orderDestinationNot retried automaticallyApproval before production
Creates a draft Sales Order. Submission and cancellation stay in ERPNext.
sales_orders.create - Get sales orderSource
Reads one Sales Order with child tables and custom fields.
sales_orders.get - List sales ordersSourceIncremental
Lists ERPNext Sales Order documents by modification time.
sales_orders.list - Update sales orderDestinationProvider duplicate protectionApproval before production
Updates fields of a Sales Order; submitted documents only accept fields allowed on submit.
sales_orders.update
session
- Get API userSource
Returns the user the API key belongs to (connection check).
session.get
stock entries
- Create stock entryDestinationNot retried automaticallyApproval before production
Creates a draft Stock Entry (always saved as draft; never submitted). Submission and cancellation stay in ERPNext.
stock_entries.create - Get stock entrySource
Reads one Stock Entry with child tables and custom fields.
stock_entries.get - List stock entrysSourceIncremental
Lists ERPNext Stock Entry documents by modification time.
stock_entries.list
suppliers
- Create supplierDestinationNot retried automaticallyApproval before production
Creates a draft Supplier. Submission and cancellation stay in ERPNext.
suppliers.create - Get supplierSource
Reads one Supplier with child tables and custom fields.
suppliers.get - List suppliersSourceIncremental
Lists ERPNext Supplier documents by modification time.
suppliers.list - Update supplierDestinationProvider duplicate protectionApproval before production
Updates fields of a Supplier; submitted documents only accept fields allowed on submit.
suppliers.update
tasks
- Create taskDestinationNot retried automaticallyApproval before production
Creates a draft Task. Submission and cancellation stay in ERPNext.
tasks.create - Get taskSource
Reads one Task with child tables and custom fields.
tasks.get - List tasksSourceIncremental
Lists ERPNext Task documents by modification time.
tasks.list - Update taskDestinationProvider duplicate protectionApproval before production
Updates fields of a Task; submitted documents only accept fields allowed on submit.
tasks.update
Authentication
API key and API secret (token authentication)
Plans and access
Self-hosted ERPNext (v14+) or Frappe Cloud sites. Access follows the API user's roles and user permissions; document submission is left to ERPNext workflows.
Test environment
Use a Frappe Cloud trial site or a local bench site.
Rate limits
No default API limit; sites may configure rate limiting, and Frappe Cloud plans apply request quotas (HTTP 429).
Pagination
limit_start/limit_page_length (up to 500) ordered by modified ascending.
Provider events
ERPNext Webhook DocType (document events with optional HMAC signature). Nexra event triggers are not yet available; flows run on demand or on a schedule.
Before you build a flow
- Only the allow-listed DocTypes are reachable; generic operations cannot address other DocTypes.
- Documents are created as drafts; submit, cancel, amend and delete are not implemented. Stock entries are create-only drafts and payment entries are read only.
- The modified filter compares Frappe's site-time-zone timestamps with the UTC wall-clock value you supply.
- List reads return parent fields only; child tables (items) come from single reads.
- ERPNext has no idempotency key for creates; uncertain creates are not repeated automatically.
Developer reference
- Create the Frappe Technologies credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose ERPNext, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/erpnext and the Connections API.