Create Account
POST {{baseUrl}}/api/v1/accounts
This API creates an account in your help desk portal.
OAuth Scope
Desk.contacts.CREATE
Attributes
| Attribute Name | Data Type | Description |
|---|---|---|
| customFields | <list> | User-defined fields associated with the account |
| cf | <JSONObject> | User-defined fields associated with the account |
| accountName (required) | <string> max chars : 200 | Name of the account |
| <string> max chars : 150 | Email ID of the account | |
| website | <string> max chars : 120 | Website of the account |
| fax | <string> max chars : 100 | Fax number of the account |
| ownerId | <long> | ID of account owner |
| associatedSLAIds | <list> | IDs of the SLAs associated with the account. An account can have multiple SLAs, but only one SLA per department can be mapped to it. |
| industry | <string> max chars : 120 | Industry in which the account operates |
| city | <string> max chars : 100 | City in which the account is based |
| country | <string> max chars : 100 | Country in which the account is based |
| state | <string> max chars : 100 | State in which the account is based |
| street | <string> max chars : 250 | Address of the account |
| code | <string> max chars : 100 | Zip code |
| description | <string> max chars : 65535 | A short description of the account |
| phone | <string> max chars : 100 | Phone number of the account |
| annualrevenue | <double> | Annual revenue of the account |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"country":null,"modifiedTime":"2015-03-02T14:49:18.000Z","website":null,"code":null,"cf":{"cf_contactcount":null},"isFollowing":"true","accountName":"Zylker","city":null,"associatedSLAIds":[3263000000057,3000000057001],"description":null,"industry":null,"zohoCRMAccount":{"id":"32754000000537001"},"ownerId":"3263000000057001","isDeleted":false,"isTrashed":false,"phone":"98348229382","street":null,"annualrevenue":null,"webUrl":"https://desk.zoho.com/support/zylker/ShowHomePage.do#Accounts/dv/d126330fb061247d9ebddaeb9d93ba74750b0284bc703b38","createdTime":"2015-02-16T16:57:44.000Z","state":null,"id":"3263000000074571","fax":null,"email":null}