API Workflows
Xano workspace 4 exposes REST APIs organized by domain. All endpoints require authentication unless noted.API Groups
| Group | Description | Tag |
|---|---|---|
| products | Product catalog CRUD | AR:products |
| b2b | Distributors, contacts, purchase orders | AR:b2b |
| finance | Invoices, payments, AR aging | AR:financials |
| integrations | External system sync | AR:integrations |
| agents | AI-powered automation | AR:agents |
| webhooks | Inbound from Shopify, Xero, Stripe | AR:webhooks |
Products API
CRUD operations for the product catalog.Endpoints
| Method | Path | Description |
|---|---|---|
GET | /products | List all products |
GET | /products/{product_id} | Get single product |
POST | /products | Create product |
PATCH | /products/{product_id} | Update product |
GET | /variants | List all variants |
POST | /variants | Create variant |
PATCH | /variants/{variant_id} | Update variant |
B2B API
Manage distributors, contacts, and purchase orders.Distributors
| Method | Path | Description |
|---|---|---|
GET | /distributors | List distributors |
GET | /distributors/{distributor_id} | Get distributor |
POST | /distributors | Create distributor |
PATCH | /distributors/{distributor_id} | Update distributor |
Contacts
| Method | Path | Description |
|---|---|---|
GET | /contacts | List contacts |
POST | /contacts | Create contact |
PATCH | /contacts/{contact_id} | Update contact |
Purchase Orders
| Method | Path | Description |
|---|---|---|
GET | /purchase-orders | List POs |
GET | /purchase-orders/{po_id} | Get PO details |
POST | /purchase-orders | Create PO |
PATCH | /purchase-orders/{po_id} | Update PO |
POST | /purchase-orders/{po_id}/confirm | Confirm PO |
POST | /purchase-orders/{po_id}/lines | Add line items |
AI-Powered PO Processing
| Method | Path | Description |
|---|---|---|
POST | /pdf_parsing | Parse PDF purchase order via AI |
POST | /create_order_from_parsed | Create PO from parsed data |
Finance API
Invoice management, payments, and AR tracking.Invoices
| Method | Path | Description |
|---|---|---|
GET | /invoices | List invoices |
GET | /invoices/{invoice_id} | Get invoice |
POST | /invoices | Create invoice |
PATCH | /invoices/{invoice_id} | Update invoice |
POST | /invoices/{invoice_id}/send | Send invoice email |
POST | /invoices/{invoice_id}/xero | Push to Xero |
Payments
| Method | Path | Description |
|---|---|---|
POST | /payments | Record payment |
AR Management
| Method | Path | Description |
|---|---|---|
GET | /ar-aging | AR aging report |
POST | /purchase-orders/{po_id}/invoice | Generate invoice from PO |
Integrations API
Sync status and triggers for external systems.| Method | Path | Description |
|---|---|---|
GET | /status | Integration health check |
POST | /xero/push-invoice/{invoice_id} | Push invoice to Xero |
POST | /shopify/sync-products | Sync products to Shopify |
POST | /shopify/sync-inventory | Sync inventory levels |
AI Agents API
AI-powered automation for PO parsing and AR collection.| Method | Path | Description |
|---|---|---|
POST | /po-parse | Parse PO document (AI agent) |
POST | /ar-nudge/{invoice_id} | Send AR reminder for single invoice |
POST | /ar-nudge/batch | Batch AR nudge for overdue invoices |
Webhooks API
Inbound webhooks from external systems.| Method | Path | Description |
|---|---|---|
POST | /shopify/orders | Shopify order created/updated |
POST | /shopify/products | Shopify product sync |
POST | /xero/invoices | Xero invoice webhook |
POST | /stripe/payments | Stripe payment events |
AI Agents
PO Parser
Automatically extracts line items from PDF purchase orders. Capabilities:- Parses variable PDF formats from different distributors
- Extracts: PO number, line items, quantities, SKUs
- Returns confidence score (0-1)
- Creates draft PO for human review
[email protected] or manual upload
AR Nudger
Sends automated payment reminders for overdue invoices. Capabilities:- Generates personalized reminder emails
- Escalates tone based on days overdue
- Tracks nudge history per invoice
- Respects contact preferences
Functions
Reusable backend functions.| Function | Description |
|---|---|
b2b/process_parsed_po | Process AI-parsed PO data into draft order |
generate_invoice_html | Generate HTML invoice view (trigger) |
Authentication
All APIs use JWT authentication via the Authentication group:| Method | Path | Description |
|---|---|---|
POST | /auth/login | Login with email/password |
POST | /auth/signup | Create new user |
GET | /auth/me | Get current user |
GET | /reset/request-reset-link | Request password reset |
POST | /reset/magic-link-login | Login via magic link |
POST | /reset/update_password | Update password |