Customers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

A customer entity allows you to maintain information about a customer.

Download Customers OpenAPI Document

End Points

POST

/contacts/{customer_id}

GET

/contacts/{customer_id}

DELETE

/contacts/{customer_id}

Attribute

contact_id

string

Unique ID for the contact. This is used as an identifier.

contact_name

string

Name of the contact.

company_name

string

Registered name of the company the contact represents.

website

string

Website of the contact.

contact_salutation

string

Salutation of the contact person. Possible values are Mr or Mrs or Miss or Ms or Dr

has_transaction

boolean

Whether the Contact has transactions. It can either be trueor false.

contact_type

string

Type of the contact.

source

string

Source of the contact.

is_crm_customer

boolean

Whether the Contact is a CRM customer. It can either be trueor false.

is_linked_with_zohocrm

boolean

Whether the Contact is linked with ZOHO CRM. It can either be trueor false.

primary_contact_id

string

Unique ID for Primary contact.

payment_terms

integer

Payment terms for contact.

payment_terms_label

string

Payment term label.

currency_id

string

Unique ID for currency.

currency_code

string

Base currency of contact.

currency_symbol

string

Symbol of the currency.

price_precision

integer

Precise amount upto n decimal points.

status

string

Status of the contact. It can either be activeor inactive.

vat_reg_no

string

Reg no. of VAT.

vat_treatment

string

VAT treatment.

first_name

string

First name of the contact person.

last_name

string

Last name of the contact person.

string

Email address of the contact person.

phone

long

Landline phone number of the contact person.

mobile

long

Mobile number of the contact person.

twitter

string

Twitter handle of the contact person.

facebook

string

Facebook ID of the contact person.

billing_address

object

Contact's billing address object.

Show Sub-Attributes

address_id

string

Unique ID for address.

address

string

Address

city

string

City

state

string

State

zip

string

Zip Code

country

string

Country

fax

string

Fax Number

attention

string

attention

shipping_address

object

Contact's shipping address object.

Show Sub-Attributes

address_id

string

Unique ID for address.

address

string

Address

city

string

City

state

string

State

zip

string

Zip Code

country

string

Country

fax

string

Fax Number

attention

string

attention

contact_persons

array

List of contact persons for the contact. It contains contact_person_id, salutation, first_name,last_name,email,phone,mobile and is_primary_contact.

Show Sub-Attributes

contact_person_id

string

Unique ID for contact person. This is used as an identifier.

salutation

string

Salutation of the contact person. Possible values are Mr or Mrs or Miss or Ms or Dr

first_name

string

First name of the contact person.

last_name

string

Last name of the contact person.

string

Email address of the contact person.

phone

long

Landline phone number of the contact person.

mobile

long

Mobile number of the contact person.

department

string

Department of the contact person.

designation

string

Designation of the contact person.

skype

string

Skype Name / Number of the contact person.

fax

string

Fax Number

can_invite

boolean

Whether the contact person is allowed to invite others. It can either be true or false.

is_primary_contact

boolean

Whether this person is the primary contact person for this contact. It can either be true or false.

notes

string

A short note about the contact.

custom_fields

array

Custom fields for a customer.

Show Sub-Attributes

customfield_id

string

Unique identifier of the custom field

value

string

Value of the Custom Field

created_time

string

Time at which the contact details were created.

last_modified_time

string

Time at which the contact details were last updated.

{
    "contact_id": "16367000000096001",
    "contact_name": "Kenny Digital",
    "company_name": "Kenny Digital",
    "website": "kennedyr.com",
    "contact_salutation": "Mr",
    "has_transaction": false,
    "contact_type": "customer",
    "source": "user",
    "is_crm_customer": false,
    "is_linked_with_zohocrm": false,
    "primary_contact_id": "16367000000096003",
    "payment_terms": 0,
    "payment_terms_label": "Due on Receipt",
    "currency_id": "16367000000000097",
    "currency_code": "USD",
    "currency_symbol": "$",
    "price_precision": 2,
    "status": "active",
    "vat_reg_no": "",
    "vat_treatment": "",
    "first_name": "Ken",
    "last_name": "Kennedy",
    "email": "ken.kennedy@gmail.com",
    "phone": "235456",
    "mobile": "9566977190",
    "twitter": "kenkennedy",
    "facebook": "ken.kennedy",
    "billing_address": {
        "address_id": "16367000000096004",
        "address": "3500, Bayshore, Burlingame",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94010",
        "country": "USA",
        "fax": "342-421234",
        "attention": ""
    },
    "shipping_address": {
        "address_id": "16367000000096004",
        "address": "3500, Bayshore, Burlingame",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94010",
        "country": "USA",
        "fax": "342-421234",
        "attention": ""
    },
    "contact_persons": [
        {
            "contact_person_id": "16367000000096003",
            "salutation": "Mr.",
            "first_name": "Ken",
            "last_name": "Kennedy",
            "email": "ken.kennedy@gmail.com",
            "phone": "235456",
            "mobile": "9566977190",
            "department": "",
            "designation": "",
            "skype": "Kenny",
            "fax": "342-421234",
            "can_invite": true,
            "is_primary_contact": true
        }
    ],
    "notes": "note",
    "custom_fields": [
        {
            "customfield_id": "46000000012845",
            "value": "Normal"
        }
    ],
    "created_time": "2017-02-28T10:36:40+0530",
    "last_modified_time": "2017-02-28T10:36:40+0530"
}

Create a new customer or contact person AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Create a new customer.
OAuth Scope : ZohoExpense.contacts.CREATE

Arguments

contact_name

string

(Required)

Name of the contact.

company_name

string

Registered name of the company the contact represents.

website

string

Website of the contact.

string

Email address of the contact person.

mobile

long

Mobile number of the contact person.

twitter

string

Twitter handle of the contact person.

facebook

string

Facebook ID of the contact person.

phone

long

Landline phone number of the contact person.

custom_fields

array

Custom fields for a customer.

Show Sub-Attributes

customfield_id

string

Unique identifier of the custom field

value

string

Value of the Custom Field

billing_address

object

Contact's billing address object.

Show Sub-Attributes

address_id

string

Unique ID for address.

address

string

Address

city

string

City

state

string

State

zip

string

Zip Code

country

string

Country

fax

string

Fax Number

attention

string

attention

shipping_address

object

Contact's shipping address object.

Show Sub-Attributes

address_id

string

Unique ID for address.

address

string

Address

city

string

City

state

string

State

zip

string

Zip Code

country

string

Country

fax

string

Fax Number

attention

string

attention

contact_persons

array

List of contact persons for the contact. It contains contact_person_id, salutation, first_name,last_name,email,phone,mobile and is_primary_contact.

Show Sub-Attributes

contact_person_id

string

Unique ID for contact person. This is used as an identifier.

salutation

string

Salutation of the contact person. Possible values are Mr or Mrs or Miss or Ms or Dr

first_name

string

First name of the contact person.

last_name

string

Last name of the contact person.

string

Email address of the contact person.

phone

long

Landline phone number of the contact person.

mobile

long

Mobile number of the contact person.

department

string

Department of the contact person.

designation

string

Designation of the contact person.

skype

string

Skype Name / Number of the contact person.

fax

string

Fax Number

can_invite

boolean

Whether the contact person is allowed to invite others. It can either be true or false.

is_primary_contact

boolean

Whether this person is the primary contact person for this contact. It can either be true or false.

Headers

X-com-zoho-expense-organizationid

string

(Required)

ID of the organization

Request Example

parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("X-com-zoho-expense-organizationid", "10234695");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/expense/v1/contacts"
type: POST
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.zohoapis.com/expense/v1/contacts")
  .post(body)
  .addHeader("X-com-zoho-expense-organizationid", "10234695")
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'POST',
  headers: {
    'X-com-zoho-expense-organizationid': '10234695',
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://www.zohoapis.com/expense/v1/contacts', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'X-com-zoho-expense-organizationid': "10234695",
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("POST", "/expense/v1/contacts", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "POST",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/expense/v1/contacts",
  "headers": {
    "X-com-zoho-expense-organizationid": "10234695",
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    "content-type": "application/json"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();

curl --request POST \
  --url https://www.zohoapis.com/expense/v1/contacts \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'X-com-zoho-expense-organizationid: 10234695' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "contact_name": "Kenny Digital",
    "company_name": "Kenny Digital",
    "website": "kennedyr.com",
    "email": "ken.kennedy@gmail.com",
    "mobile": "9566977190",
    "twitter": "kenkennedy",
    "facebook": "ken.kennedy",
    "phone": "235456",
    "custom_fields": [
        {
            "customfield_id": "46000000012845",
            "value": "Normal"
        }
    ],
    "billing_address": {
        "address_id": "16367000000096004",
        "address": "3500, Bayshore, Burlingame",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94010",
        "country": "USA",
        "fax": "342-421234",
        "attention": ""
    },
    "shipping_address": {
        "address_id": "16367000000096004",
        "address": "3500, Bayshore, Burlingame",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94010",
        "country": "USA",
        "fax": "342-421234",
        "attention": ""
    },
    "contact_persons": [
        {
            "contact_person_id": "16367000000096003",
            "salutation": "Mr.",
            "first_name": "Ken",
            "last_name": "Kennedy",
            "email": "ken.kennedy@gmail.com",
            "phone": "235456",
            "mobile": "9566977190",
            "department": "",
            "designation": "",
            "skype": "Kenny",
            "fax": "342-421234",
            "can_invite": true,
            "is_primary_contact": true
        }
    ]
}

{
    "code": 0,
    "message": "The customer has been created.",
    "contact": {
        "contact_id": "16367000000096001",
        "contact_name": "Kenny Digital",
        "company_name": "Kenny Digital",
        "website": "kennedyr.com",
        "contact_salutation": "Mr",
        "has_transaction": false,
        "contact_type": "customer",
        "source": "user",
        "is_crm_customer": false,
        "is_linked_with_zohocrm": false,
        "primary_contact_id": "16367000000096003",
        "payment_terms": 0,
        "payment_terms_label": "Due on Receipt",
        "currency_id": "16367000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "price_precision": 2,
        "status": "active",
        "vat_reg_no": "",
        "vat_treatment": "",
        "first_name": "Ken",
        "last_name": "Kennedy",
        "email": "ken.kennedy@gmail.com",
        "phone": "235456",
        "mobile": "9566977190",
        "twitter": "kenkennedy",
        "facebook": "ken.kennedy",
        "billing_address": {
            "address_id": "16367000000096004",
            "address": "3500, Bayshore, Burlingame",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94010",
            "country": "USA",
            "fax": "342-421234",
            "attention": ""
        },
        "shipping_address": {
            "address_id": "16367000000096004",
            "address": "3500, Bayshore, Burlingame",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94010",
            "country": "USA",
            "fax": "342-421234",
            "attention": ""
        },
        "contact_persons": [
            {
                "contact_person_id": "16367000000096003",
                "salutation": "Mr.",
                "first_name": "Ken",
                "last_name": "Kennedy",
                "email": "ken.kennedy@gmail.com",
                "phone": "235456",
                "mobile": "9566977190",
                "department": "",
                "designation": "",
                "skype": "Kenny",
                "fax": "342-421234",
                "can_invite": true,
                "is_primary_contact": true
            }
        ],
        "notes": "note",
        "custom_fields": [
            {
                "customfield_id": "46000000012845",
                "value": "Normal"
            }
        ],
        "created_time": "2017-02-28T10:36:40+0530",
        "last_modified_time": "2017-02-28T10:36:40+0530"
    }
}

List all customers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List of all customers.
OAuth Scope : ZohoExpense.customer.READ

Query Parameters

page

integer

Page number to be fetched. Default value is 1.

per_page

integer

Number of records to be fetched per page. Default value is 200.

Headers

X-com-zoho-expense-organizationid

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("X-com-zoho-expense-organizationid", "10234695");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/expense/v1/contacts"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/expense/v1/contacts")
  .get()
  .addHeader("X-com-zoho-expense-organizationid", "10234695")
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    'X-com-zoho-expense-organizationid': '10234695',
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/expense/v1/contacts', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = {
    'X-com-zoho-expense-organizationid': "10234695",
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
    }

conn.request("GET", "/expense/v1/contacts", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/expense/v1/contacts",
  "headers": {
    "X-com-zoho-expense-organizationid": "10234695",
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url https://www.zohoapis.com/expense/v1/contacts \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'X-com-zoho-expense-organizationid: 10234695'

{
    "code": 0,
    "message": "success",
    "customers": [
        {
            "contact_id": "16367000000096001",
            "contact_name": "Kenny Digital",
            "company_name": "Kenny Digital",
            "contact_type": "customer",
            "status": "active",
            "source": "user",
            "is_linked_with_zohocrm": false,
            "currency_id": "16367000000000097",
            "currency_code": "USD",
            "first_name": "Ken",
            "last_name": "Kennedy",
            "email": "ken.kennedy@gmail.com",
            "phone": "235456",
            "mobile": "9566977190",
            "custom_fields": [
                {
                    "customfield_id": "46000000012845",
                    "value": "Normal"
                }
            ],
            "created_time": "2017-02-28T10:36:40+0530",
            "last_modified_time": "2017-02-28T10:36:40+0530"
        },
        {...},
        {...}
    ]
}

Update a customer AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Update the details of an existing customer.
OAuth Scope : ZohoExpense.customer.UPDATE

Arguments

contact_name

string

Name of the contact.

company_name

string

Registered name of the company the contact represents.

website

string

Website of the contact.

notes

string

A short note about the contact.

string

Email address of the contact person.

phone

long

Landline phone number of the contact person.

facebook

string

Facebook ID of the contact person.

mobile

long

Mobile number of the contact person.

custom_fields

array

Custom fields for a customer.

Show Sub-Attributes

customfield_id

string

Unique identifier of the custom field

value

string

Value of the Custom Field

billing_address

object

Contact's billing address object.

Show Sub-Attributes

address_id

string

Unique ID for address.

address

string

Address

city

string

City

state

string

State

zip

string

Zip Code

country

string

Country

fax

string

Fax Number

attention

string

attention

Path Parameters

customer_id

string

(Required)

Unique identifier of the customer.

Headers

X-com-zoho-expense-organizationid

string

(Required)

ID of the organization

Request Example

parameters_data='{"field1":"value1","field2":"value2"}';
headers_data = Map();
headers_data.put("X-com-zoho-expense-organizationid", "10234695");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/expense/v1/contacts/16367000000096001"
type: PUT
headers: headers_data
content-type: application/json
parameters: parameters_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"field1\":\"value1\",\"field2\":\"value2\"}");
Request request = new Request.Builder()
  .url("https://www.zohoapis.com/expense/v1/contacts/16367000000096001")
  .put(body)
  .addHeader("X-com-zoho-expense-organizationid", "10234695")
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'PUT',
  headers: {
    'X-com-zoho-expense-organizationid': '10234695',
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f',
    'content-type': 'application/json'
  },
  body: '{"field1":"value1","field2":"value2"}'
};

fetch('https://www.zohoapis.com/expense/v1/contacts/16367000000096001', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

payload = "{\"field1\":\"value1\",\"field2\":\"value2\"}"

headers = {
    'X-com-zoho-expense-organizationid': "10234695",
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    'content-type': "application/json"
    }

conn.request("PUT", "/expense/v1/contacts/16367000000096001", payload, headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "PUT",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/expense/v1/contacts/16367000000096001",
  "headers": {
    "X-com-zoho-expense-organizationid": "10234695",
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f",
    "content-type": "application/json"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(JSON.stringify({field1: 'value1', field2: 'value2'}));
req.end();

curl --request PUT \
  --url https://www.zohoapis.com/expense/v1/contacts/16367000000096001 \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'X-com-zoho-expense-organizationid: 10234695' \
  --header 'content-type: application/json' \
  --data '{"field1":"value1","field2":"value2"}'

{
    "contact_name": "Kenny Digital",
    "company_name": "Kenny Digital",
    "website": "kennedyr.com",
    "notes": "note",
    "email": "ken.kennedy@gmail.com",
    "phone": "235456",
    "facebook": "ken.kennedy",
    "mobile": "9566977190",
    "custom_fields": [
        {
            "customfield_id": "46000000012845",
            "value": "Normal"
        }
    ],
    "billing_address": {
        "address_id": "16367000000096004",
        "address": "3500, Bayshore, Burlingame",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94010",
        "country": "USA",
        "fax": "342-421234",
        "attention": ""
    }
}

{
    "code": 0,
    "message": "Customer information has been saved.",
    "contact": {
        "contact_id": "16367000000096001",
        "contact_name": "Kenny Digital",
        "company_name": "Kenny Digital",
        "website": "kennedyr.com",
        "contact_salutation": "Mr",
        "has_transaction": false,
        "contact_type": "customer",
        "source": "user",
        "is_crm_customer": false,
        "is_linked_with_zohocrm": false,
        "primary_contact_id": "16367000000096003",
        "payment_terms": 0,
        "payment_terms_label": "Due on Receipt",
        "currency_id": "16367000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "price_precision": 2,
        "status": "active",
        "vat_reg_no": "",
        "vat_treatment": "",
        "first_name": "Ken",
        "last_name": "Kennedy",
        "email": "ken.kennedy@gmail.com",
        "phone": "235456",
        "mobile": "9566977190",
        "twitter": "kenkennedy",
        "facebook": "ken.kennedy",
        "billing_address": {
            "address_id": "16367000000096004",
            "address": "3500, Bayshore, Burlingame",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94010",
            "country": "USA",
            "fax": "342-421234",
            "attention": ""
        },
        "shipping_address": {
            "address_id": "16367000000096004",
            "address": "3500, Bayshore, Burlingame",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94010",
            "country": "USA",
            "fax": "342-421234",
            "attention": ""
        },
        "contact_persons": [
            {
                "contact_person_id": "16367000000096003",
                "salutation": "Mr.",
                "first_name": "Ken",
                "last_name": "Kennedy",
                "email": "ken.kennedy@gmail.com",
                "phone": "235456",
                "mobile": "9566977190",
                "department": "",
                "designation": "",
                "skype": "Kenny",
                "fax": "342-421234",
                "can_invite": true,
                "is_primary_contact": true
            }
        ],
        "notes": "note",
        "custom_fields": [
            {
                "customfield_id": "46000000012845",
                "value": "Normal"
            }
        ],
        "created_time": "2017-02-28T10:36:40+0530",
        "last_modified_time": "2017-02-28T10:36:40+0530"
    }
}

Retrieve details of a customer AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Details of an existing customer.
OAuth Scope : ZohoExpense.customer.READ

Path Parameters

customer_id

string

(Required)

Unique identifier of the customer.

Headers

X-com-zoho-expense-organizationid

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("X-com-zoho-expense-organizationid", "10234695");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/expense/v1/contacts/16367000000096001"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/expense/v1/contacts/16367000000096001")
  .get()
  .addHeader("X-com-zoho-expense-organizationid", "10234695")
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    'X-com-zoho-expense-organizationid': '10234695',
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/expense/v1/contacts/16367000000096001', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = {
    'X-com-zoho-expense-organizationid': "10234695",
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
    }

conn.request("GET", "/expense/v1/contacts/16367000000096001", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/expense/v1/contacts/16367000000096001",
  "headers": {
    "X-com-zoho-expense-organizationid": "10234695",
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url https://www.zohoapis.com/expense/v1/contacts/16367000000096001 \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'X-com-zoho-expense-organizationid: 10234695'

{
    "code": 0,
    "message": "success",
    "contact": {
        "contact_id": "16367000000096001",
        "contact_name": "Kenny Digital",
        "company_name": "Kenny Digital",
        "website": "kennedyr.com",
        "contact_salutation": "Mr",
        "has_transaction": false,
        "contact_type": "customer",
        "source": "user",
        "is_crm_customer": false,
        "is_linked_with_zohocrm": false,
        "primary_contact_id": "16367000000096003",
        "payment_terms": 0,
        "payment_terms_label": "Due on Receipt",
        "currency_id": "16367000000000097",
        "currency_code": "USD",
        "currency_symbol": "$",
        "price_precision": 2,
        "status": "active",
        "vat_reg_no": "",
        "vat_treatment": "",
        "first_name": "Ken",
        "last_name": "Kennedy",
        "email": "ken.kennedy@gmail.com",
        "phone": "235456",
        "mobile": "9566977190",
        "twitter": "kenkennedy",
        "facebook": "ken.kennedy",
        "billing_address": {
            "address_id": "16367000000096004",
            "address": "3500, Bayshore, Burlingame",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94010",
            "country": "USA",
            "fax": "342-421234",
            "attention": ""
        },
        "shipping_address": {
            "address_id": "16367000000096004",
            "address": "3500, Bayshore, Burlingame",
            "city": "San Francisco",
            "state": "CA",
            "zip": "94010",
            "country": "USA",
            "fax": "342-421234",
            "attention": ""
        },
        "contact_persons": [
            {
                "contact_person_id": "16367000000096003",
                "salutation": "Mr.",
                "first_name": "Ken",
                "last_name": "Kennedy",
                "email": "ken.kennedy@gmail.com",
                "phone": "235456",
                "mobile": "9566977190",
                "department": "",
                "designation": "",
                "skype": "Kenny",
                "fax": "342-421234",
                "can_invite": true,
                "is_primary_contact": true
            }
        ],
        "notes": "note",
        "custom_fields": [
            {
                "customfield_id": "46000000012845",
                "value": "Normal"
            }
        ],
        "created_time": "2017-02-28T10:36:40+0530",
        "last_modified_time": "2017-02-28T10:36:40+0530"
    }
}

Delete a customer AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Delete an existing customer.
OAuth Scope : ZohoExpense.contacts.DELETE

Path Parameters

customer_id

string

(Required)

Unique identifier of the customer.

Headers

X-com-zoho-expense-organizationid

string

(Required)

ID of the organization

Request Example

headers_data = Map();
headers_data.put("X-com-zoho-expense-organizationid", "10234695");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://www.zohoapis.com/expense/v1/contacts/16367000000096001"
type: DELETE
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.zohoapis.com/expense/v1/contacts/16367000000096001")
  .delete(null)
  .addHeader("X-com-zoho-expense-organizationid", "10234695")
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'DELETE',
  headers: {
    'X-com-zoho-expense-organizationid': '10234695',
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://www.zohoapis.com/expense/v1/contacts/16367000000096001', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("www.zohoapis.com")

headers = {
    'X-com-zoho-expense-organizationid': "10234695",
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
    }

conn.request("DELETE", "/expense/v1/contacts/16367000000096001", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "DELETE",
  "hostname": "www.zohoapis.com",
  "port": null,
  "path": "/expense/v1/contacts/16367000000096001",
  "headers": {
    "X-com-zoho-expense-organizationid": "10234695",
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request DELETE \
  --url https://www.zohoapis.com/expense/v1/contacts/16367000000096001 \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f' \
  --header 'X-com-zoho-expense-organizationid: 10234695'

{
    "code": 0,
    "message": "The customer has been deleted."
}

Customers AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Attribute

Arguments

Headers

List all customers AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Query Parameters

Headers

Update a customer AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Arguments

Path Parameters

Headers

Retrieve details of a customer AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Headers

Delete a customer AI Tools Open in ChatGPT Open in ChatGPT to ask questions about this page Open in Claude Open in Claude to ask questions about this page Copy as Markdown Copy this page as markdown to use with AI assistants View as Markdown Open this page as markdown in a new tab

Path Parameters

Headers

Customers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

List all customers AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Update a customer AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab

Delete a customer AI Tools

Open in ChatGPT

Open in ChatGPT to ask questions about this page

Open in Claude

Open in Claude to ask questions about this page

Copy as Markdown

Copy this page as markdown to use with AI assistants

View as Markdown

Open this page as markdown in a new tab