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
Email	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"
        }
    ]
}

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"
}