Create a Company

Purpose

To insert a new company record.

Request URL

https://fsm.zoho.com/fsm/v1/Companies

Request Method

POST

Scope

scope=ZohoFSM.modules.Companies.CREATE

Name	Description	Type
Company_Name	The name of the company	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 company	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/Companies' \
-d "@newContact.json" \
--header 'Authorization: Zoho-oauthtoken 1000.63706db******************************d96d4a5'

Sample Input

Copied{
    "data": [
        {
            "Company_Name": "Zylker",
            "Website": "www.zylker.com",
            "Email": "lucy.robins@zylker.com",
            "Phone": "555-555-5555",
            "Mobile": null,
            "Company_Type": "Customer",
            "Service_Address": 
                {
                    "Address_Name": "Service Address",
                    "Street_1": "523 S Webster St",
                    "Street_2": null,
                    "City": "Naperville",
                    "State": "Illinois",
                    "Zip_Code": "60540",
                    "Country": "United States",
                    "Territory": "1011000000139175",
                    "Tax": {
                        "Taxable": true,
                        "Tax_Name": "IllinoisExciseTax",
                        "Tax_Authority": null,
                        "Tax_Percentage": 6.25,
                        "Tax_Exemption_Id": null,
                        "Tax_Id": "2908070000000092001",
                        "Tax_Exemption_Code": null,
                        "Tax_Authority_Id": null
                    }
                },
            "Billing_Address": 
                {
                    "Address_Name": "Billing Address",
                    "Street_1": "2639 Aurora Ave",
                    "Street_2": null,
                    "City": "Naperville",
                    "State": "Illinois",
                    "Zip_Code": "60540",
                    "Country": "United States",
                    "Territory": null,
                    "Tax": {
                        "Taxable": true,
                        "Tax_Name": "IllinoisExciseTax",
                        "Tax_Authority": null,
                        "Tax_Percentage": 6.25,
                        "Tax_Exemption_Id": null,
                        "Tax_Id": "2908070000000092001",
                        "Tax_Exemption_Code": null,
                        "Tax_Authority_Id": null
                    }
                },
            "Tax": {
                "Taxable": true,
                "Tax_Name": "IllinoisExciseTax",
                "Tax_Id": "2908070000000092001",
                "Tax_Exemption_Code": null,
                "Tax_Authority": null,
                "Tax_Exemption_Id": null,
                "Tax_Percentage": 6.25,
                "Tax_Authority_Id": null
            },
            "Currency": "USD",
            "Exchange_Rate": "1.000000000"
        }
    ]
}

Sample Response

Copied{
    "result": "success",
    "code": "SUCCESS",
    "data": {
        "Companies": [
            {
                "UID": "Companies_0",
                "Modified_Time": "2022-04-03T23:52:13-07:00",
                "Modified_By": {
                    "name": "Daniel Warne",
                    "id": "1011000000139001"
                },
                "Created_Time": "2022-04-03T23:52:13-07:00",
                "id": "1011000000254082",
                "Created_By": {
                    "name": "Daniel Warne",
                    "id": "1011000000139001"
                },
                "TabName": "Accounts"
            }
        ]
    },
    "status": "success"
}