phacility/phabricator · warning · PhutilArgumentUsageException

Unable to load specified webhook

Error message

Unable to load specified webhook ("%s").

What it means

'bin/herald call-webhook' loads the webhook with HeraldWebhookQuery restricted to withIDs(array($id)) as the CLI admin viewer; when no row matches, this usage exception is thrown. Since the viewer is an admin, the practical cause is that no webhook with that numeric ID exists.

Solutions

1. Open the Webhooks console (/webhook/) and use the numeric ID shown there.
2. Confirm you are running the command against the correct database/environment.
3. If you only have the PHID, look up its numeric ID in the webhook URL or database, then re-run with --id.

Example fix

// before
./bin/herald call-webhook --id 999 --object T123
// after
./bin/herald call-webhook --id 3 --object T123

// Verify the webhook exists before shelling out:
$hook = id(new HeraldWebhookQuery())
  ->setViewer(PhabricatorUser::getOmnipotentUser())
  ->withIDs(array($id))
  ->executeOne();
if (!$hook) {
  throw new InvalidArgumentException('No webhook with id '.$id);
}

When it happens

Trigger: Running './bin/herald call-webhook --id 999' when 999 does not exist; using an ID copied from a different environment; the webhook was deleted after the ID was recorded.

Common situations: Environment mismatch (dev ID used on prod); webhook deleted or recreated with a new ID; passing the PHID (PHID-HWEB-...) where the numeric ID is required.

Understand the failure class

Background: "Not found" and "does not exist" errors: why "Task not found", "No such folder", and "Can't find" fire when a lookup comes back empty — this error's family across 14 libraries.

Related errors

• Unable to load specified object
• Specified "--count" must be larger than 0.
• Specify a webhook to call with "--id".
• Unable to load object
• Associated hook (" ") for webhook request (" ") is disabled.

AI-assisted analysis of phacility/phabricator@5720a38cfe (2026-08-21). Data as JSON: /api/errors/bcf8683c6dd3c7b4. Report an issue: GitHub.

Appendix: source

Thrown at src/applications/herald/management/HeraldWebhookCallManagementWorkflow.php:71

    }

    $count = $args->getArg('count');
    if ($count === null) {
      $count = 1;
    }

    if ($count <= 0) {
      throw new PhutilArgumentUsageException(
        pht(
          'Specified "--count" must be larger than 0.'));
    }

    $hook = id(new HeraldWebhookQuery())
      ->setViewer($viewer)
      ->withIDs(array($id))
      ->executeOne();
    if (!$hook) {
      throw new PhutilArgumentUsageException(
        pht(
          'Unable to load specified webhook ("%s").',
          $id));
    }

    $object_name = $args->getArg('object');
    if ($object_name === null) {
      $object = $hook;
    } else {
      $objects = id(new PhabricatorObjectQuery())
        ->setViewer($viewer)
        ->withNames(array($object_name))
        ->execute();
      if (!$objects) {
        throw new PhutilArgumentUsageException(
          pht(
            'Unable to load specified object ("%s").',
            $object_name));

View on GitHub (pinned to 5720a38cfe)