Skip to main content

pan triggers

Added in v0.73.0.
Create, list, remove and set the signing secret of webhook triggers: secret URLs that send an event to a conversation or start a conversation in a project. Every subcommand except add --inbox works without a running dashboard; it writes ~/.overdeck/triggers.json directly, and the dashboard reads that file on every event. See Webhook triggers.

add

Pass exactly one of --conversation and --project; otherwise it exits 1. An unknown conversation or project exits 1. A trigger name is 1 to 64 characters: letters, digits, spaces, ., _ and -. It prints the hook path, the local test URL (http://127.0.0.1:<port>/hooks/…), the Funnel URL (https://<machine>.<tailnet>.ts.net:8443/hooks/… unless a .ts.net address is saved), any generated signing secret, a set-secret reminder for a stripe trigger without a secret, the Funnel command, and then:
With --inbox, the trigger is created through the dashboard, which asks the directory for the inbox. It prints the inbox URL instead of the Funnel lines:
With the dashboard not running, on a free account, signed out, or when the directory does not answer within 10 seconds, it creates nothing and exits 1 with the reason. See Hold events with the directory inbox.

list

Lists triggers with columns ID NAME TARGET VERIFY SIGNING SECRET CREATED. TARGET is conversation <name> or project <key>; SIGNING SECRET is - for none triggers and secret set or secret not set for github and stripe triggers. It never prints a secret. With no triggers it prints:

remove

Removes the trigger. Its URL answers 404 from the next event on. It does not delete a directory inbox; remove an inbox trigger in Settings → Anywhere → Triggers so its inbox is deleted too:
An unknown id prints No trigger with id <id>. and exits 1.

set-secret

Sets the signing secret of a github or stripe trigger, for example a Stripe endpoint’s whsec_… secret. Without --secret it reads one line from standard input, so the secret stays out of your shell history:
On success it prints Set the signing secret for trigger <id>. An empty value, or one that is not 8 to 256 characters without whitespace, exits 1. An unknown id prints No trigger with id <id>. and exits 1.

Get help

Still stuck? Ask on the Overdeck Discord or file a GitHub Issue.