Add Scheduled Job

api/v3/Job/Contactcatsync.mgd.php

@@ -0,0 +1,21 @@
+<?php
+
+// This file declares a managed database record of type "Job".
+// The record will be automatically inserted, updated, or deleted from the
+// database as appropriate. For more details, see "hook_civicrm_managed" at:
+// https://docs.civicrm.org/dev/en/latest/hooks/hook_civicrm_managed
+return [
+  [
+    'name' => 'Cron:Job.Contactcatsync',
+    'entity' => 'Job',
+    'params' => [
+      'version' => 3,
+      'name' => 'Contact Category sync',
+      'description' => 'Keeps contacts’s categories updated daily, recording change activities to track over time. Should be run hourly but will only actually work around 3am.',
+      'run_frequency' => 'Hourly',
+      'api_entity' => 'Job',
+      'api_action' => 'Contactcatsync',
+      'parameters' => '',
+    ],
+  ],
+];

api/v3/Job/Contactcatsync.php

@@ -0,0 +1,36 @@
+<?php
+
+use Civi\Api4\ContactCategory;
+
+/**
+ * Job.Contactcatsync API specification
+ *
+ * This ensures that the contact categories are applied each night. It is a simple wrapper
+ * around ContactCategory.Sync api4 action. It can be called hourly but the api4 activity
+ * will ensure it only runs once a day, around 3am (server timezone).
+ *
+ * @param array $spec description of fields supported by this API call
+ *
+ * @see https://docs.civicrm.org/dev/en/latest/framework/api-architecture/
+ */
+function _civicrm_api3_job_Contactcatsync_spec(&$spec) {
+}
+
+/**
+ * Job.Contactcatsync API
+ *
+ * @param array $params
+ *
+ * @return array
+ *   API result descriptor
+ *
+ * @see civicrm_api3_create_success
+ *
+ * @throws CRM_Core_Exception
+ */
+function civicrm_api3_job_Contactcatsync($params) {
+  $returnValues = ContactCategory::sync(FALSE)
+    ->execute()->getArrayCopy();
+
+  return civicrm_api3_create_success($returnValues, $params, 'Job', 'Contactcatsync');
+}