API Docs
/
No Results Found
Contact-Persons

Contact-Persons

A contact person is customer’s additional point of contact.

Attribute

contactperson_id
string
Unique ID generated by the server.This can be used as an identifier.
first_name
string
First name of the contact person.
last_name
string
Last name of the contact person.
email
string
Email ID of the contact person to whom notifications regarding the subscription needs to be sent.
mobile
string
Mobile number of the contact person.
phone
string
Landline or fixed line number of the contact person.
fax
string
Customer's fax number.
customer_id
string
Customer ID of the customer the contact person is associated with.
created_time
string
Time at which the contact person was created.
updated_time
string
Time at which the contact person details were last updated.

Example

{ "contactperson_id": "903000000053362", "first_name": "Mark", "last_name": "Cruizer", "email": "mark.cruzer@bowmanfurniture.com", "mobile": "786663728", "phone": "0417254482", "fax": 4527389, "customer_id": "903000000000099", "created_time": "2016-06-05T12:30:08-0700", "updated_time": "2016-06-05T02:30:08-0700" }

Create a contact person

Create a new contact person.
oauthscope : ZohoSubscriptions.customers.CREATE

Arguments

first_name
string
First name of the contact person.
last_name
string
Last name of the contact person.
email
string
(Required)
Email ID of the contact person to whom notifications regarding the subscription needs to be sent.
mobile
string
Mobile number of the contact person.
phone
string
Landline or fixed line number of the contact person.
fax
string
Customer's fax number.

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/customers/{customer_id}/contactpersons -X POST -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "first_name": "Mark", "last_name": "Cruizer", "email": "mark.cruzer@bowmanfurniture.com", "mobile": "786663728", "phone": "0417254482", "fax": 4527389 }

Response Example

{ "code": 0, "message": "The contactperson has been Created", "contact_person": { "contactperson_id": "903000000053362", "first_name": "Mark", "last_name": "Cruizer", "email": "mark.cruzer@bowmanfurniture.com", "mobile": "786663728", "phone": "0417254482", "fax": 4527389, "customer_id": "903000000000099", "created_time": "2016-06-05T12:30:08-0700", "updated_time": "2016-06-05T02:30:08-0700" } }

List of all contact persons

List of all contact persons of a customer.
oauthscope : ZohoSubscriptions.customers.READ

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/customers/{customer_id}/contactpersons -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "contact_persons": [ { "contactperson_id": "903000000053362", "first_name": "Mark", "last_name": "Cruizer", "email": "mark.cruzer@bowmanfurniture.com", "mobile": "786663728", "phone": "0417254482" }, {...}, {...} ] }

Update a contact person

Update the details of an existing contact person.
oauthscope : ZohoSubscriptions.customers.UPDATE

Arguments

first_name
string
First name of the contact person.
last_name
string
Last name of the contact person.
email
string
(Required)
Email ID of the contact person to whom notifications regarding the subscription needs to be sent.
mobile
string
Mobile number of the contact person.
phone
string
Landline or fixed line number of the contact person.
created_time
string
Time at which the contact person was created.
updated_time
string
Time at which the contact person details were last updated.

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/customers/{customer_id}/contactpersons/{contactperson_id} -X PUT -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Content-Type: application/json;charset=UTF-8" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f" -d '{"field":"value","field":"value"}'

Body Parameters

Click to copy
{ "first_name": "Mark", "last_name": "Cruizer", "email": "mark.cruzer@bowmanfurniture.com", "mobile": "786663728", "phone": "0417254482", "created_time": "2016-06-05T12:30:08-0700", "updated_time": "2016-06-05T02:30:08-0700" }

Response Example

{ "code": 0, "message": "The contactperson details has been updated.", "contact_person": { "contactperson_id": "903000000053362", "first_name": "Mark", "last_name": "Cruizer", "email": "mark.cruzer@bowmanfurniture.com", "mobile": "786663728", "phone": "0417254482", "fax": 4527389, "customer_id": "903000000000099", "created_time": "2016-06-05T12:30:08-0700", "updated_time": "2016-06-05T02:30:08-0700" } }

Retrieve a contact person

Details of an existing contact person.
oauthscope : ZohoSubscriptions.customers.READ

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/customers/{customer_id}/contactpersons/{contactperson_id} -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

{ "code": 0, "message": "success", "contact_person": { "contactperson_id": "903000000053362", "first_name": "Mark", "last_name": "Cruizer", "email": "mark.cruzer@bowmanfurniture.com", "mobile": "786663728", "phone": "0417254482", "fax": 4527389, "customer_id": "903000000000099", "created_time": "2016-06-05T12:30:08-0700", "updated_time": "2016-06-05T02:30:08-0700" } }

Delete a contact person

Delete an existing contact person.
oauthscope : ZohoSubscriptions.customers.DELETE

Request Example

Click to copy
$ curl https://subscriptions.zoho.com/api/v1/customers/{customer_id}/contactpersons/{contactperson_id} -X DELETE -H "X-com-zoho-subscriptions-organizationid: 10234695" -H "Authorization: Zoho-oauthtoken 1000.41d9f2cfbd1b7a8f9e314b7aff7bc2d1.8fcc9810810a216793f385b9dd6e125f"

Response Example

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