Function create

packages/cli/src/commands/webhooks/create.ts:24–283

(client: Client, argv: string[])

  'https://vercel.com/docs/webhooks/webhooks-api';

export default async function create(client: Client, argv: string[]) {
  const telemetry = new WebhooksCreateTelemetryClient({
    opts: {
      store: client.telemetryEventStore,
    },
  });

  let parsedArgs;
  const flagsSpecification = getFlagsSpecification(createSubcommand.options);
  try {
    parsedArgs = parseArguments(argv, flagsSpecification);
  } catch (error) {
    printError(error);
    return 1;
  }
  const { args, flags: opts } = parsedArgs;
  let [url] = args;

  // --- Collect URL ---
  if (!url) {
    if (client.nonInteractive) {
      const argv = client.argv.slice(2);
      const subcommandParts = argv.slice(0, 2); // e.g. ['webhooks', 'create']
      const rest = argv.slice(2);
      const subcommandWithPlaceholder = `${subcommandParts.join(' ')} <url>${
        rest.length ? ` ${rest.join(' ')}` : ''
      }`;
      outputAgentError(
        client,
        {
          status: AGENT_STATUS.ERROR,
          reason: AGENT_REASON.MISSING_URL,
          message:
            'Webhook URL is required. Provide URL as the first argument.',
          next: [
            {
              command: getCommandNamePlain(subcommandWithPlaceholder),
            },
          ],
        },
        1
      );
    }
    url = await client.input.text({
      message: 'Webhook URL:',
      validate: (val: string) => {
        if (!val) return 'URL is required';
        try {
          const urlObj = new URL(val);
          if (!['http:', 'https:'].includes(urlObj.protocol)) {
            return 'Webhook URL must use http or https protocol';
          }
        } catch {
          return 'Invalid URL';
        }
        return true;
      },
    });