/cats-companies | Type: Application | PCID required: Yes
Tools
cats_companies_add_department
Add department Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company to add department on. |
name | string | Yes | — | The name value |
cats_companies_attach_company_tags
Attach company tags Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company to attach tags to. |
tags | any[] | No | — | The tags value |
cats_companies_change_a_company_thumbnail
Change a company thumbnail Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to change the thumbnail of. |
_links | object | No | — | The links value |
attachment_id | number | No | — | Only required if source is set to attachment (must be an attachment belonging to the data item)## Trigger (object) |
description | string | No | — | The description value |
is_default | boolean | No | — | Is Default |
is_required | boolean | No | — | Is Required |
source | string | No | — | One of attachment, clearbit, or disabled. |
cats_companies_change_company_status
Change company status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company that the status is being attached to. |
status_id | number | Yes | — | The ID of the status to attach. |
triggers | any[] | No | — | An 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
check_duplicate | boolean | Yes | — | When 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. |
address | object | No | — | An object containing the address for the company with the following structure: { "street": "<street>", "city": "<city>", "state": "<state>", "postal_code": "<postal code>" } |
billing_contact_id | number | No | — | Billing Contact Id |
country_code | string | No | — | Country Code |
custom_fields | any[] | No | — | An 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_id | number | No | — | Entered By Id |
is_hot | boolean | No | — | Is Hot |
key_technologies | string | No | — | Key Technologies |
name | string | Yes | — | The name value |
notes | string | No | — | The notes value |
owner_id | number | Yes | — | Owner Id |
phones | any[] | No | — | An 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_urls | any[] | No | — | Social Media Urls |
user_groups | any[] | No | — | User groups allowed to access this company |
website | string | No | — | The website value |
cats_companies_create_a_company_list
Create a company list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | Yes | — | The name value |
notes | string | No | — | The notes value |
cats_companies_create_a_company_phone
Create a company phone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The company to create the phone for. |
extension | string | No | — | The extension value |
number | string | Yes | — | This number MUST begin with the country code. It will not be parsed correctly otherwise. |
type | string | Yes | — | One of fax, main, or other. |
cats_companies_create_company_list_items
Create company list items Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company list. |
items | any[] | No | — | The items value |
cats_companies_delete_a_company
Delete a company Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to delete. |
cats_companies_delete_a_company_list
Delete a company list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company list to delete. |
cats_companies_delete_a_company_list_item
Delete a company list item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
list_id | number | Yes | — | The ID of the company list. |
item_id | number | Yes | — | The ID of the list item to delete. |
cats_companies_delete_a_company_phone
Delete a company phone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The company to delete the phone from. |
id | number | Yes | — | The ID of the phone to delete. |
cats_companies_delete_company_tag
Delete company tag Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company to detach the tag from. |
tag_id | number | Yes | — | The ID of the tag to detach. |
cats_companies_delete_department
Delete department Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
department_id | number | Yes | — | The ID of the department to delete. |
cats_companies_filter_companies
Filter companies Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | The optional string to search within companies for. |
page | number | Yes | — | The current page number of companies to return. |
per_page | number | Yes | — | The number of companies to return per page. |
field | string | Yes | — | The field to filter on. See the above list to determine which fields can be filtered. |
filter | string | Yes | — | The filter to use. See the above list to determine which fields allow what filters. |
value | string | Yes | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to return. |
cats_companies_get_a_company_custom_field
Get a company custom field Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the custom field definition to return. |
cats_companies_get_a_company_custom_field_value
Get a company custom field value Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company that the custom field belongs to. |
custom_field_id | number | Yes | — | The ID of the custom field to return. |
cats_companies_get_a_company_list_item
Get a company list item Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
list_id | number | Yes | — | The ID of the company list the item belongs to. |
item_id | number | Yes | — | The ID of the company list item to return. |
cats_companies_get_a_company_phone
Get a company phone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The company to return the phone for. |
id | number | Yes | — | The ID of the phone to return. |
cats_companies_get_a_company_status
Get a company status Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the status to return. |
cats_companies_get_a_company_thumbnail
Get a company thumbnail Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to get the thumbnail of. |
cats_companies_get_a_department
Get a department Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the department to return. |
cats_companies_get_a_list
Get a list Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company list to return. |
cats_companies_list_all_companies
List all companies Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | Yes | — | The current page number of companies to return. |
per_page | number | Yes | — | The number of companies to return per page. |
cats_companies_list_all_company_list_items
List all company list items Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company list to return items for. |
page | number | Yes | — | The current page number of list items to return. |
per_page | number | Yes | — | The number of list items to return per page. |
cats_companies_list_all_company_lists
List all company lists Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | Yes | — | The current page number of lists to return. |
per_page | number | Yes | — | The number of lists to return per page. |
cats_companies_list_all_company_tags
List all company tags Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company to return tags for. |
page | number | Yes | — | The current page number of tags to return. |
per_page | number | Yes | — | The number of tags to return per page. |
cats_companies_list_all_departments
List all departments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company to return departments for. |
page | number | Yes | — | The current page number of departments to return. |
per_page | number | Yes | — | The number of departments to return per page. |
cats_companies_list_company_attachments
List company attachments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to return attachments for. |
page | number | Yes | — | The current page number of attachments to return. |
per_page | number | Yes | — | The number of attachments to return per page. |
cats_companies_list_company_custom_field_values
List company custom field values Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to return custom fields for. |
page | number | Yes | — | The current page number of custom fields to return. |
per_page | number | Yes | — | The number of custom fields to return per page. |
cats_companies_list_company_custom_fields
List company custom fields Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | Yes | — | The current page number of custom field definitions to return. |
per_page | number | Yes | — | The number of custom field definitions to return per page. |
cats_companies_list_company_phones
List company phones Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The company to return phones for. |
page | number | Yes | — | The current page number of phones to return. |
per_page | number | Yes | — | The number of phones to return per page. |
cats_companies_list_company_statuses
List company statuses Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | number | Yes | — | The current page number of statuses to return. |
per_page | number | Yes | — | The number of statuses to return per page. |
cats_companies_list_company_tasks
List company tasks Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to fetch tasks concerning. |
page | number | Yes | — | The current page number of tasks to return. |
per_page | number | Yes | — | The number of task items to return per page. |
cats_companies_replace_company_tags
Replace company tags Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company to replace tags on. |
tags | any[] | No | — | The tags value |
cats_companies_search_companies
Search companies Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | The string to search within companies for. |
page | number | Yes | — | The current page number of companies to return. |
per_page | number | Yes | — | The number of companies to return per page. |
cats_companies_update_a_company
Update a company Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company to update. |
address | object | No | — | An object containing the address for the company with the following structure: { "street": "<street>", "city": "<city>", "state": "<state>", "postal_code": "<postal code>" } |
billing_contact_id | number | No | — | Billing Contact Id |
country_code | string | No | — | Country Code |
custom_fields | any[] | No | — | An 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_id | number | No | — | Entered By Id |
is_hot | boolean | No | — | Is Hot |
key_technologies | string | No | — | Key Technologies |
name | string | No | — | The name value |
notes | string | No | — | The notes value |
owner_id | number | No | — | Owner Id |
phones | any[] | No | — | An 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_urls | any[] | No | — | Social Media Urls |
user_groups | any[] | No | — | User groups allowed to access this company |
website | string | No | — | The website value |
cats_companies_update_a_company_custom_field
Update a company custom field Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The ID of the company that the custom field belongs to. |
custom_field_id | number | Yes | — | The ID of the custom field to update. |
value | string | No | — | The value value |
cats_companies_update_a_company_phone
Update a company phone Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
company_id | number | Yes | — | The company to update the phone for. |
id | number | Yes | — | The ID of the phone to update. |
extension | string | No | — | The extension value |
number | string | No | — | This number MUST begin with the country code. It will not be parsed correctly otherwise. |
type | string | No | — | One of fax, main, or other. |
cats_companies_update_department
Update department Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
department_id | number | Yes | — | The ID of the department to update. |
name | string | No | — | The name value |
cats_companies_upload_a_company_attachment
Upload a company attachment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | number | Yes | — | The ID of the company that the attachment is being attached to. |
filename | string | Yes | — | The name to save the file being uploaded as. |

