Skip to main content
Server path: /cats-companies | Type: Application | PCID required: Yes

Tools

ToolDescription
cats_companies_add_departmentAdd department
cats_companies_attach_company_tagsAttach company tags
cats_companies_change_a_company_thumbnailChange a company thumbnail
cats_companies_change_company_statusChange company status
cats_companies_create_a_companyCreate a company
cats_companies_create_a_company_listCreate a company list
cats_companies_create_a_company_phoneCreate a company phone
cats_companies_create_company_list_itemsCreate company list items
cats_companies_delete_a_companyDelete a company
cats_companies_delete_a_company_listDelete a company list
cats_companies_delete_a_company_list_itemDelete a company list item
cats_companies_delete_a_company_phoneDelete a company phone
cats_companies_delete_company_tagDelete company tag
cats_companies_delete_departmentDelete department
cats_companies_filter_companiesFilter companies
cats_companies_get_a_companyGet a company
cats_companies_get_a_company_custom_fieldGet a company custom field
cats_companies_get_a_company_custom_field_valueGet a company custom field value
cats_companies_get_a_company_list_itemGet a company list item
cats_companies_get_a_company_phoneGet a company phone
cats_companies_get_a_company_statusGet a company status
cats_companies_get_a_company_thumbnailGet a company thumbnail
cats_companies_get_a_departmentGet a department
cats_companies_get_a_listGet a list
cats_companies_list_all_companiesList all companies
cats_companies_list_all_company_list_itemsList all company list items
cats_companies_list_all_company_listsList all company lists
cats_companies_list_all_company_tagsList all company tags
cats_companies_list_all_departmentsList all departments
cats_companies_list_company_attachmentsList company attachments
cats_companies_list_company_custom_field_valuesList company custom field values
cats_companies_list_company_custom_fieldsList company custom fields
cats_companies_list_company_phonesList company phones
cats_companies_list_company_statusesList company statuses
cats_companies_list_company_tasksList company tasks
cats_companies_replace_company_tagsReplace company tags
cats_companies_search_companiesSearch companies
cats_companies_update_a_companyUpdate a company
cats_companies_update_a_company_custom_fieldUpdate a company custom field
cats_companies_update_a_company_phoneUpdate a company phone
cats_companies_update_departmentUpdate department
cats_companies_upload_a_company_attachmentUpload a company attachment

cats_companies_add_department

Add department Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company to add department on.
namestringYesThe name value

cats_companies_attach_company_tags

Attach company tags Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company to attach tags to.
tagsany[]NoThe tags value

cats_companies_change_a_company_thumbnail

Change a company thumbnail Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to change the thumbnail of.
_linksobjectNoThe links value
attachment_idnumberNoOnly required if source is set to attachment (must be an attachment belonging to the data item)## Trigger (object)
descriptionstringNoThe description value
is_defaultbooleanNoIs Default
is_requiredbooleanNoIs Required
sourcestringNoOne of attachment, clearbit, or disabled.

cats_companies_change_company_status

Change company status Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company that the status is being attached to.
status_idnumberYesThe ID of the status to attach.
triggersany[]NoAn array of objects each containing the ID of an attached trigger and a boolean representing whether or not to fire the trigger. If the triggers parameter is not set, all required triggers will be fired as well as all triggers that are marked as optional and on by default. Optional triggers that are off by default will not fire. If the triggers parameter is specified, all triggers that are attached to the status must be included in the array and the API will make no assumptions about which triggers to fire. Example: [ { "id": <trigger ID>, "fire": <boolean> } ]

cats_companies_create_a_company

Create a company Parameters:
ParameterTypeRequiredDefaultDescription
check_duplicatebooleanYesWhen this flag is set to true, if a duplicate record is found to the one being created, an error will be thrown instead of creating a duplicate record. Defaults to false.
addressobjectNoAn object containing the address for the company with the following structure: { "street": "<street>", "city": "<city>", "state": "<state>", "postal_code": "<postal code>" }
billing_contact_idnumberNoBilling Contact Id
country_codestringNoCountry Code
custom_fieldsany[]NoAn array of custom field objects. Each custom field object should contain two keys: id and value. id is the id of a custom field definition, and value is the value to be set to that custom field for this company. [ { "id": <custom field definition id>, "value": "<custom field value>" } ]
entered_by_idnumberNoEntered By Id
is_hotbooleanNoIs Hot
key_technologiesstringNoKey Technologies
namestringYesThe name value
notesstringNoThe notes value
owner_idnumberYesOwner Id
phonesany[]NoAn array of phone objects. Each phone object should contain three keys: number, extension, and type, as described here [ { "number": <phone number with country code>, "extension": "<optional extension>", "type": "<phone number type>", } ]
social_media_urlsany[]NoSocial Media Urls
user_groupsany[]NoUser groups allowed to access this company
websitestringNoThe website value

cats_companies_create_a_company_list

Create a company list Parameters:
ParameterTypeRequiredDefaultDescription
namestringYesThe name value
notesstringNoThe notes value

cats_companies_create_a_company_phone

Create a company phone Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe company to create the phone for.
extensionstringNoThe extension value
numberstringYesThis number MUST begin with the country code. It will not be parsed correctly otherwise.
typestringYesOne of fax, main, or other.

cats_companies_create_company_list_items

Create company list items Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company list.
itemsany[]NoThe items value

cats_companies_delete_a_company

Delete a company Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to delete.

cats_companies_delete_a_company_list

Delete a company list Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company list to delete.

cats_companies_delete_a_company_list_item

Delete a company list item Parameters:
ParameterTypeRequiredDefaultDescription
list_idnumberYesThe ID of the company list.
item_idnumberYesThe ID of the list item to delete.

cats_companies_delete_a_company_phone

Delete a company phone Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe company to delete the phone from.
idnumberYesThe ID of the phone to delete.

cats_companies_delete_company_tag

Delete company tag Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company to detach the tag from.
tag_idnumberYesThe ID of the tag to detach.

cats_companies_delete_department

Delete department Parameters:
ParameterTypeRequiredDefaultDescription
department_idnumberYesThe ID of the department to delete.

cats_companies_filter_companies

Filter companies Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesThe optional string to search within companies for.
pagenumberYesThe current page number of companies to return.
per_pagenumberYesThe number of companies to return per page.
fieldstringYesThe field to filter on. See the above list to determine which fields can be filtered.
filterstringYesThe filter to use. See the above list to determine which fields allow what filters.
valuestringYesThe value to filter by. Different filters take different value types (string, array, int). See the section in the introduction to see what values each filter accepts.

cats_companies_get_a_company

Get a company Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to return.

cats_companies_get_a_company_custom_field

Get a company custom field Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the custom field definition to return.

cats_companies_get_a_company_custom_field_value

Get a company custom field value Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company that the custom field belongs to.
custom_field_idnumberYesThe ID of the custom field to return.

cats_companies_get_a_company_list_item

Get a company list item Parameters:
ParameterTypeRequiredDefaultDescription
list_idnumberYesThe ID of the company list the item belongs to.
item_idnumberYesThe ID of the company list item to return.

cats_companies_get_a_company_phone

Get a company phone Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe company to return the phone for.
idnumberYesThe ID of the phone to return.

cats_companies_get_a_company_status

Get a company status Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the status to return.

cats_companies_get_a_company_thumbnail

Get a company thumbnail Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to get the thumbnail of.

cats_companies_get_a_department

Get a department Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the department to return.

cats_companies_get_a_list

Get a list Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company list to return.

cats_companies_list_all_companies

List all companies Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberYesThe current page number of companies to return.
per_pagenumberYesThe number of companies to return per page.

cats_companies_list_all_company_list_items

List all company list items Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company list to return items for.
pagenumberYesThe current page number of list items to return.
per_pagenumberYesThe number of list items to return per page.

cats_companies_list_all_company_lists

List all company lists Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberYesThe current page number of lists to return.
per_pagenumberYesThe number of lists to return per page.

cats_companies_list_all_company_tags

List all company tags Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company to return tags for.
pagenumberYesThe current page number of tags to return.
per_pagenumberYesThe number of tags to return per page.

cats_companies_list_all_departments

List all departments Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company to return departments for.
pagenumberYesThe current page number of departments to return.
per_pagenumberYesThe number of departments to return per page.

cats_companies_list_company_attachments

List company attachments Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to return attachments for.
pagenumberYesThe current page number of attachments to return.
per_pagenumberYesThe number of attachments to return per page.

cats_companies_list_company_custom_field_values

List company custom field values Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to return custom fields for.
pagenumberYesThe current page number of custom fields to return.
per_pagenumberYesThe number of custom fields to return per page.

cats_companies_list_company_custom_fields

List company custom fields Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberYesThe current page number of custom field definitions to return.
per_pagenumberYesThe number of custom field definitions to return per page.

cats_companies_list_company_phones

List company phones Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe company to return phones for.
pagenumberYesThe current page number of phones to return.
per_pagenumberYesThe number of phones to return per page.

cats_companies_list_company_statuses

List company statuses Parameters:
ParameterTypeRequiredDefaultDescription
pagenumberYesThe current page number of statuses to return.
per_pagenumberYesThe number of statuses to return per page.

cats_companies_list_company_tasks

List company tasks Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to fetch tasks concerning.
pagenumberYesThe current page number of tasks to return.
per_pagenumberYesThe number of task items to return per page.

cats_companies_replace_company_tags

Replace company tags Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company to replace tags on.
tagsany[]NoThe tags value

cats_companies_search_companies

Search companies Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesThe string to search within companies for.
pagenumberYesThe current page number of companies to return.
per_pagenumberYesThe number of companies to return per page.

cats_companies_update_a_company

Update a company Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company to update.
addressobjectNoAn object containing the address for the company with the following structure: { "street": "<street>", "city": "<city>", "state": "<state>", "postal_code": "<postal code>" }
billing_contact_idnumberNoBilling Contact Id
country_codestringNoCountry Code
custom_fieldsany[]NoAn array of custom field objects. Each custom field object should contain two keys: id and value. id is the id of a custom field definition, and value is the value to be set to that custom field for this company. [ { "id": <custom field definition id>, "value": "<custom field value>" } ]
entered_by_idnumberNoEntered By Id
is_hotbooleanNoIs Hot
key_technologiesstringNoKey Technologies
namestringNoThe name value
notesstringNoThe notes value
owner_idnumberNoOwner Id
phonesany[]NoAn array of phone objects. Each phone object should contain three keys: number, extension, and type, as described here [ { "number": <phone number with country code>, "extension": "<optional extension>", "type": "<phone number type>", } ]
social_media_urlsany[]NoSocial Media Urls
user_groupsany[]NoUser groups allowed to access this company
websitestringNoThe website value

cats_companies_update_a_company_custom_field

Update a company custom field Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe ID of the company that the custom field belongs to.
custom_field_idnumberYesThe ID of the custom field to update.
valuestringNoThe value value

cats_companies_update_a_company_phone

Update a company phone Parameters:
ParameterTypeRequiredDefaultDescription
company_idnumberYesThe company to update the phone for.
idnumberYesThe ID of the phone to update.
extensionstringNoThe extension value
numberstringNoThis number MUST begin with the country code. It will not be parsed correctly otherwise.
typestringNoOne of fax, main, or other.

cats_companies_update_department

Update department Parameters:
ParameterTypeRequiredDefaultDescription
department_idnumberYesThe ID of the department to update.
namestringNoThe name value

cats_companies_upload_a_company_attachment

Upload a company attachment Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the company that the attachment is being attached to.
filenamestringYesThe name to save the file being uploaded as.