3.1 KiB
3.1 KiB
Zoho Books Routing Reference
App name: zoho-books
Base URL proxied: www.zohoapis.com
API Path Pattern
/zoho-books/books/v3/{resource}
Common Endpoints
Contacts
# List contacts
GET /zoho-books/books/v3/contacts
# Get contact
GET /zoho-books/books/v3/contacts/{contact_id}
# Create contact
POST /zoho-books/books/v3/contacts
Content-Type: application/json
{
"contact_name": "Customer Name",
"contact_type": "customer"
}
# Update contact
PUT /zoho-books/books/v3/contacts/{contact_id}
# Delete contact
DELETE /zoho-books/books/v3/contacts/{contact_id}
Invoices
# List invoices
GET /zoho-books/books/v3/invoices
# Get invoice
GET /zoho-books/books/v3/invoices/{invoice_id}
# Create invoice
POST /zoho-books/books/v3/invoices
# Mark as sent
POST /zoho-books/books/v3/invoices/{invoice_id}/status/sent
# Email invoice
POST /zoho-books/books/v3/invoices/{invoice_id}/email
Bills
# List bills
GET /zoho-books/books/v3/bills
# Create bill
POST /zoho-books/books/v3/bills
# Update bill
PUT /zoho-books/books/v3/bills/{bill_id}
# Delete bill
DELETE /zoho-books/books/v3/bills/{bill_id}
Expenses
# List expenses
GET /zoho-books/books/v3/expenses
# Create expense
POST /zoho-books/books/v3/expenses
# Update expense
PUT /zoho-books/books/v3/expenses/{expense_id}
# Delete expense
DELETE /zoho-books/books/v3/expenses/{expense_id}
Sales Orders
GET /zoho-books/books/v3/salesorders
POST /zoho-books/books/v3/salesorders
Purchase Orders
GET /zoho-books/books/v3/purchaseorders
POST /zoho-books/books/v3/purchaseorders
Credit Notes
GET /zoho-books/books/v3/creditnotes
Recurring Invoices
GET /zoho-books/books/v3/recurringinvoices
Recurring Bills
GET /zoho-books/books/v3/recurringbills
Available Modules
| Module | Endpoint | Description |
|---|---|---|
| Contacts | /contacts |
Customers and vendors |
| Invoices | /invoices |
Sales invoices |
| Bills | /bills |
Vendor bills |
| Expenses | /expenses |
Business expenses |
| Sales Orders | /salesorders |
Sales orders |
| Purchase Orders | /purchaseorders |
Purchase orders |
| Credit Notes | /creditnotes |
Customer credit notes |
| Recurring Invoices | /recurringinvoices |
Recurring invoices |
| Recurring Bills | /recurringbills |
Recurring bills |
Notes
- All successful responses have
code: 0 - Dates should be in
yyyy-mm-ddformat - Contact types are
customerorvendor - Some modules (items, chart of accounts, bank accounts, projects) require additional OAuth scopes
- Rate limits: 100 requests/minute per organization
- Pagination uses
pageandper_pageparameters withhas_more_pagein response