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

Tools

ToolDescription
cats_admin_create_a_backupCreate a backup
cats_admin_create_a_taskCreate a task
cats_admin_create_a_webhookCreate a webhook
cats_admin_delete_a_taskDelete a task
cats_admin_delete_a_webhookDelete a webhook
cats_admin_delete_a_work_historyDelete a work history
cats_admin_delete_an_activityDelete an activity
cats_admin_delete_an_attachmentDelete an attachment
cats_admin_download_an_attachmentDownload an attachment
cats_admin_filter_activitiesFilter activities
cats_admin_get_a_backupGet a backup
cats_admin_get_a_portalGet a portal
cats_admin_get_a_tagGet a tag
cats_admin_get_a_taskGet a task
cats_admin_get_a_triggerGet a trigger
cats_admin_get_a_userGet a user
cats_admin_get_a_webhookGet a webhook
cats_admin_get_a_work_historyGet a work history
cats_admin_get_an_activityGet an activity
cats_admin_get_an_attachmentGet an attachment
cats_admin_get_portal_registration_applicationGet portal registration application
cats_admin_get_siteGet site
cats_admin_list_all_activitiesList all activities
cats_admin_list_all_backupsList all backups
cats_admin_list_all_events_starting_after_a_timestampList all events starting after a timestamp
cats_admin_list_all_portalsList all portals
cats_admin_list_all_tagsList all tags
cats_admin_list_all_tasksList all tasks
cats_admin_list_all_triggersList all triggers
cats_admin_list_all_usersList all users
cats_admin_list_all_webhooksList all webhooks
cats_admin_list_portal_jobsList portal jobs
cats_admin_parse_a_resumeParse a resume
cats_admin_publish_portal_jobPublish portal job
cats_admin_search_activitiesSearch activities
cats_admin_submitSubmit
cats_admin_submit_portal_registration_applicationSubmit portal registration application
cats_admin_unpublish_portal_jobUnpublish portal job
cats_admin_update_a_taskUpdate a task
cats_admin_update_a_work_historyUpdate a work history
cats_admin_update_an_activityUpdate an activity

cats_admin_create_a_backup

Create a backup Parameters:
ParameterTypeRequiredDefaultDescription
include_attachmentsbooleanNoWhether to include attachments in the backup or not. Running a backup without attachments can greatly speed up the backup time. Defaults to false.
include_emailsbooleanNoWhether to include emails in the backup or not. Running a backup without emails can greatly speed up the backup time. Defaults to true.

cats_admin_create_a_task

Create a task Parameters:
ParameterTypeRequiredDefaultDescription
assigned_to_idnumberNoThe user to assign the task to
data_itemobjectNoA DataItem the object is about, or null for a general task
date_duestringNoIf null the task will be assigned ASAP as in the CATS UI
descriptionstringNoThe description value
prioritynumberNoA number 1-5, with 1 being the lowest priority

cats_admin_create_a_webhook

Create a webhook Parameters:
ParameterTypeRequiredDefaultDescription
eventsany[]YesAn array of one or more of the following event types: candidate.created, job.created, contact.created, company.created, activity.created, user.created, pipeline.created, candidate.updated, job.updated, contact.updated, company.updated, activity.updated, user.updated, candidate.deleted, job.deleted, contact.deleted, company.deleted, activity.deleted, user.deleted, pipeline.deleted, job.status_changed, contact.status_changed, company.status_changed, pipeline.status_changed
secretstringNoHighly Recommended. If provided, you can use this string to verify that authenticity of webhooks sent to target_url. All webhooks you subscribe to you will send a X-Signature header. To determine whether the X-Signature header is valid take the body of the webhook response, append the value of the X-Request-Id header to it, and then generate a HMAC-SHA256 hash of it using your secret as a key. That final result should match the hash found in the X-Signature header. Here are two examples of the verification process in PHP and Python 3: PHP $secret = 'yourSecretHere'; $webhookBody = '{}'; // `X-Request-Id` header $requestId = '5d6ce3f9-cce8-4b5b-a26e-396a6161eb99'; // `X-Signature` header $signature = 'HMAC-SHA256 affc8d589f36580daa0d587ac0b314c123b59322cf4d018661e0a403cc76391f'; $hash = hash_hmac('sha256', $requestBody . $requestId, $secret, false); if ($signature !== 'HMAC-SHA256 ' . $hash) { // Reject it }
target_urlstringYesURL to post the record to once the event is triggered.

cats_admin_delete_a_task

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

cats_admin_delete_a_webhook

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

cats_admin_delete_a_work_history

Delete a work history Parameters:
ParameterTypeRequiredDefaultDescription
work_history_idnumberYesThe ID of the work history to delete.

cats_admin_delete_an_activity

Delete an activity Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the activity to delete.

cats_admin_delete_an_attachment

Delete an attachment Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the attachment to delete.

cats_admin_download_an_attachment

Download an attachment Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the attachment to download.

cats_admin_filter_activities

Filter activities Parameters:
ParameterTypeRequiredDefaultDescription
querystringYesThe optional string to search within activities for.
pagenumberYesThe current page number of activities to return.
per_pagenumberYesThe number of activities 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_admin_get_a_backup

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

cats_admin_get_a_portal

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

cats_admin_get_a_tag

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

cats_admin_get_a_task

Get a task Parameters:
ParameterTypeRequiredDefaultDescription
idstringYesThe ID of the task to return.

cats_admin_get_a_trigger

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

cats_admin_get_a_user

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

cats_admin_get_a_webhook

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

cats_admin_get_a_work_history

Get a work history Parameters:
ParameterTypeRequiredDefaultDescription
work_history_idnumberYesThe ID of the work history to return.

cats_admin_get_an_activity

Get an activity Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the activity to return.

cats_admin_get_an_attachment

Get an attachment Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the attachment to return.

cats_admin_get_portal_registration_application

Get portal registration application Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the portal to return registration application for.

cats_admin_get_site

Get site

cats_admin_list_all_activities

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

cats_admin_list_all_backups

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

cats_admin_list_all_events_starting_after_a_timestamp

List all events starting after a timestamp Parameters:
ParameterTypeRequiredDefaultDescription
starting_after_timestampnumberYesGet up to 25 events immediately following (but not including) this timestamp

cats_admin_list_all_portals

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

cats_admin_list_all_tags

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

cats_admin_list_all_tasks

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

cats_admin_list_all_triggers

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

cats_admin_list_all_users

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

cats_admin_list_all_webhooks

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

cats_admin_list_portal_jobs

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

cats_admin_parse_a_resume

Parse a resume

cats_admin_publish_portal_job

Publish portal job Parameters:
ParameterTypeRequiredDefaultDescription
portal_idnumberYesThe ID of the portal the job being submitted to is on.
job_idnumberYesThe ID of the job the application is being submitted for.

cats_admin_search_activities

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

cats_admin_submit

Submit Parameters:
ParameterTypeRequiredDefaultDescription
portal_idnumberYesThe ID of the portal the job being submitted to is on.
job_idnumberYesThe ID of the job the application is being submitted for.
fieldsany[]NoAn example with all fields types: { "fields": [ { /* file */ "id": 523423, "value": "SGVsbG8gV29ybGQ=", "filename": "helloworld.txt" }, { /* text */ "id": 523591, "value": "James" }, { /* multiline */ "id": 524022 "value": "line 1\r\nline 2" }, { /* checkbox */ "id": 524156 "value": true }, { /* checkboxes */ "id": 524221 "value": { "3251": true, "3991": true } }, { /* radio/select */ "id": 524221 "value": { "4126": true } } ], "source": "Google" }
sourcestringNoIf the applicant is brand new to the system, what you provide in the source field will be set as their source. If they are not new to the system, their existing source will NOT be overwritten. If source is not provided it defaults to “Career Portal”.

cats_admin_submit_portal_registration_application

Submit portal registration application Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the portal being submitted to.
fieldsany[]NoAn example with all fields types: { "fields": [ { /* file */ "id": 523423, "value": "SGVsbG8gV29ybGQ=", "filename": "helloworld.txt" }, { /* text */ "id": 523591, "value": "James" }, { /* multiline */ "id": 524022 "value": "line 1\r\nline 2" }, { /* checkbox */ "id": 524156 "value": true }, { /* checkboxes */ "id": 524221 "value": { "3251": true, "3991": true } }, { /* radio/select */ "id": 524221 "value": { "4126": true } } ], "source": "Google" }
sourcestringNoIf the applicant is brand new to the system, what you provide in the source field will be set as their source. If they are not new to the system, their existing source will NOT be overwritten. If source is not provided it defaults to “Career Portal”.

cats_admin_unpublish_portal_job

Unpublish portal job Parameters:
ParameterTypeRequiredDefaultDescription
portal_idnumberYesThe ID of the portal the job being submitted to is on.
job_idnumberYesThe ID of the job the application is being submitted for.

cats_admin_update_a_task

Update a task Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the task to update.
assigned_to_idnumberNoThe user to assign the task to
date_duestringNoIf null the task will be assigned ASAP as in the CATS UI
descriptionstringNoThe description value
is_completedbooleanNoIs Completed
prioritynumberNoA number 1-5, with 1 being the lowest priority

cats_admin_update_a_work_history

Update a work history Parameters:
ParameterTypeRequiredDefaultDescription
work_history_idnumberYesThe ID of the work history to update.
employerobjectNoAn object containing the employer information for a work history item with one of the following structures: { "linked": false, "name": "<employer name>", "location": { "city": "<employer city>", "state": "<employer state>" } } or { "linked": true, "company_id": 465 } Both linked and name are required fields within the first object, and linked and company_id are required in the second object.
end_datestringNoEnd date for filtering
is_currentstringNoIf this is set to true, both end_date and reason_for_leaving will be ignored.
is_verifiedbooleanNoIs Verified
reason_for_leavingstringNoReason For Leaving
start_datestringNoStart date for filtering
supervisorobjectNoAn object containing the supervisor information for a work history item with one of the following structures: { "linked": false, "name": "<supervisor name>", "phone": "<supervisor phone number>" } or { "linked": true, "contact_id": 6864 }
titlestringNoThe title value

cats_admin_update_an_activity

Update an activity Parameters:
ParameterTypeRequiredDefaultDescription
idnumberYesThe ID of the activity to update.
datestringNoThe datetime the activity took place. If not specified it defaults to the current date and time.
notesstringNoThe notes value
regarding_idnumberNoThe ID of the job order that this activity is regarding. Leave null for a general activity.
typestringNoOne of the following activity types: email, meeting, call_talked, call_lvm, call_missed, text_message or other.