Create a Contact
Purpose
To insert a new contact record.
Request URL
https://fsm.zoho.com/fsm/v1/Contacts
Request Method
POST
Scope
scope=ZohoFSM.modules.Contacts.CREATE
Mandatory Parameters
Name | Description | Type |
Last_Name | The last name of the contact | String |
The email address you want to associate with the contact | String | |
The following tax parameters will differ based on the edition chosen: | ||
Taxable | Whether taxable is true or false | Boolean |
Tax_Name | Tax name if taxable is true | String |
Tax_Exemption_Code | Tax exemption code if taxable is false | String |
Tax_Authority | A tax authority needs to be provided if taxable is false | String |
GST_Treatment | Applicable for the Indian edition | String |
Place_of_Supply | Applicable for the Indian edition | String |
Tax_Reg_Number | Applicable for the Indian edition | String |
VAT_Treatment | Applicable for the UK edition | String |
The below parameters are mandatory if multi-currency is enabled. The base currency will be applied by default. | ||
Currency | The currency you want to choose for the contact | String |
Exchange_Rate | The exchange rate w.r.t the base currency of the organization | String |
Sample Request
Copiedcurl --location --request POST 'https://fsm.zoho.com/fsm/v1/Contacts' \
-d "@newContact.json" \
--header 'Authorization: Zoho-oauthtoken 1xxx.xxxxxxxxxx'
Sample Input
Copied{
"data": [
{
"Salutation": "Ms.",
"First_Name": "Lucy",
"Last_Name": "Robins",
"Email": "lucy.robins@zylker.com",
"Phone": "111-111-1111",
"Mobile": null,
"Company": "1011000000195085",
"Service_Address":
{
"Address_Name": "Service Address",
"Street_1": "813 E State St",
"Street_2": null,
"City": "Rockford",
"State": "Illinois",
"Zip_Code": "61104",
"Country": "United States",
"Territory": "1011000000139343",
"Tax": {
"Taxable": true,
"Tax_Name": "IllinoisExciseTax",
"Tax_Authority": null,
"Tax_Percentage": 6.25,
"Tax_Exemption_Id": null,
"Tax_Exemption_Code": null,
"Tax_Id": "2908070000000092001",
"Tax_Authority_Id": null
}
},
"Billing_Address": "$SUBLOOKUP_Service_Address",
"Tax": {
"Taxable": true,
"Tax_Percentage": 6.25,
"Tax_Name": "IllinoisExciseTax",
"Tax_Exemption_Id": null,
"Tax_Exemption_Code": null,
"Tax_Id": "2908070000000092001",
"Tax_Authority": null,
"Tax_Authority_Id": null
},
"Currency": "USD",
"Exchange_Rate": "1.000000000"
}
]
}
Show full
Show less
Sample Response
Copied{
"result": "success",
"code": "SUCCESS",
"data": {
"Contacts": [
{
"UID": "Contacts_0",
"Modified_Time": "2022-03-08T02:08:01-08:00",
"Modified_By": {
"name": "Daniel Warne",
"id": "1011000000139001"
},
"Created_Time": "2022-03-08T02:08:01-08:00",
"id": "1011000000222596",
"Created_By": {
"name": "Daniel Warne",
"id": "1011000000139001"
},
"TabName": "Contacts"
}
]
},
"status": "success"
}
Show full
Show less