Zoho Invoice

Zoho Invoice is an online invoicing software used to create, send, and manage professional invoices, along with tracking payments and automating billing workflows.

Categories: Accounting

Type: zohoInvoice/v1

Connections

Version: 1

OAuth2 Authorization Code

Properties

Name	Label	Type	Required
region	Region	STRING Options zoho.eu, zoho.com, zoho.com.au, zoho.jp, zoho.in, zohocloud.ca	true
organization_id	Organization Id	STRING	true
clientId	Client Id	STRING	true
clientSecret	Client Secret	STRING	true

Actions

Create Contact

Name: createContact

Create a contact.

Properties

Name	Label	Type	Description	Required
contact_name	Contact Name	STRING	`Name of the contact.`	true
company_name	Company Name	STRING	`Name of the contact's company.`	false
website	Website	STRING	`Website of the contact.`	false
currency_id	Currency ID	STRING	`Currency ID of the customer's currency.`	false
billing_address	Billing Address	OBJECT Properties {STRING(attention), STRING(address), STRING(street2), STRING(state_code), STRING(city), STRING(state), STRING(zip), STRING(country), STRING(fax), STRING(phone)}	`Billing address of the contact.`	false
shipping_address	Shipping Address	OBJECT Properties {STRING(attention), STRING(address), STRING(street2), STRING(state_code), STRING(city), STRING(state), STRING(zip), STRING(country), STRING(fax), STRING(phone)}	`Customer's shipping address to which the goods must be delivered.`	false

Example JSON Structure

{
  "label" : "Create Contact",
  "name" : "createContact",
  "parameters" : {
    "contact_name" : "",
    "company_name" : "",
    "website" : "",
    "currency_id" : "",
    "billing_address" : {
      "attention" : "",
      "address" : "",
      "street2" : "",
      "state_code" : "",
      "city" : "",
      "state" : "",
      "zip" : "",
      "country" : "",
      "fax" : "",
      "phone" : ""
    },
    "shipping_address" : {
      "attention" : "",
      "address" : "",
      "street2" : "",
      "state_code" : "",
      "city" : "",
      "state" : "",
      "zip" : "",
      "country" : "",
      "fax" : "",
      "phone" : ""
    }
  },
  "type" : "zohoInvoice/v1/createContact"
}

Output

Type: OBJECT

Properties

Name	Type	Description
code	NUMBER	Zoho Invoice error code. This will be zero for a success response and non-zero in case of an error.
message	STRING	Message for the invoked API.
contact	OBJECT Properties {}	Created contact.

Output Example

{
  "code" : 0.0,
  "message" : "",
  "contact" : { }
}

Create Invoice

Name: createInvoice

Create an invoice for your customer.

Properties

Name	Label	Type	Description	Required
customer_id	Customer ID	STRING	`ID of the customer the invoice has to be created.`	true
use_custom_invoice_number	Use Custom Invoice Number	BOOLEAN Options true, false	`If true, create custom invoice number, if false, use auto invoice number generation.`	true
invoice_number	Invoice Number	STRING	`Number of invoice.`	true
line_items	Line Items	ARRAY Items [{STRING(item_id), NUMBER(quantity)}]	`Items in invoice.`	true
date	Invoice Date	DATE	`The date of the invoice.`	false
payment_terms	Payment Terms	INTEGER	`Payment terms in days e.g. 15, 30, 60. Invoice due date will be calculated based on this.`	false

Example JSON Structure

{
  "label" : "Create Invoice",
  "name" : "createInvoice",
  "parameters" : {
    "customer_id" : "",
    "use_custom_invoice_number" : false,
    "invoice_number" : "",
    "line_items" : [ {
      "item_id" : "",
      "quantity" : 0.0
    } ],
    "date" : "2021-01-01",
    "payment_terms" : 1
  },
  "type" : "zohoInvoice/v1/createInvoice"
}

Output

Type: OBJECT

Properties

Name	Type	Description
code	NUMBER	Zoho Invoice error code. This will be zero for a success response and non-zero in case of an error.
message	STRING	Message for the invoked API.
invoice	OBJECT Properties {}	Created invoice.

Output Example

{
  "code" : 0.0,
  "message" : "",
  "invoice" : { }
}

Create Item

Name: createItem

Create a item.

Properties

Name	Label	Type	Description	Required
name	Item Name	STRING	`Name of the item.`	true
rate	Rate	NUMBER	`Per unit price of an item.`	true
product_type	Product Type	STRING Options goods, service	`Specify the type of an item.`	true
description	Description	STRING	`Description for the item.`	false

Example JSON Structure

{
  "label" : "Create Item",
  "name" : "createItem",
  "parameters" : {
    "name" : "",
    "rate" : 0.0,
    "product_type" : "",
    "description" : ""
  },
  "type" : "zohoInvoice/v1/createItem"
}

Output

Type: OBJECT

Properties

Name	Type	Description
code	NUMBER	Zoho Invoice error code. This will be zero for a success response and non-zero in case of an error.
message	STRING	Message for the invoked API.
item	OBJECT Properties {}	Created item.

Output Example

{
  "code" : 0.0,
  "message" : "",
  "item" : { }
}

On this page