Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.
AhaSend CLI webhooks commands let you manage, forward and trigger email event webhooks; this page lists their arguments and flags. For the complete local testing workflow, use the webhook testing guide. For dashboard setup, see the webhooks guide.Before running the examples, log in with an API key that has the read, write and delete webhook scopes for all domains, and replace YOUR_RESOURCE_ID with the ID of one of your webhooks. In the --domains examples, replace example.com and example.org with domains in your account; for any other domain, the API answers 400 invalid domain: <domain>. The contact event examples need the scopes and the account that contact events describes.
Overview
ahasend webhooks [subcommand] [flags]
Available subcommands:
list - List webhooks
create - Create a webhook
get - Get a webhook
update - Update a webhook
delete - Delete a webhook
listen - Listen for webhook events in real-time
trigger - Trigger webhook events for testing
webhooks get, webhooks update, webhooks delete and webhooks trigger take the webhook ID as their positional argument. A webhook ID that is not a UUID fails with exit code 4 before any request. Find IDs with ahasend webhooks list.
Event Types
--events on list, create, update, listen and trigger takes each event by its key or by its type, such as delivered or message.delivered. See the event reference for the payloads.
Event key
Event type
Description
reception
message.reception
Email received by AhaSend
delivered
message.delivered
Email delivered to recipient
transient_error
message.transient_error
Temporary delivery failure
failed
message.failed
Permanent delivery failure
bounced
message.bounced
Email bounced
suppressed
message.suppressed
Email suppressed
opened
message.opened
Email opened by recipient
clicked
message.clicked
Link clicked in email
unsubscribed
message.unsubscribed
Recipient unsubscribed through a campaign email
complained
message.complained
Campaign email reported as spam
suppression_created
suppression.created
New suppression added
suppression_deleted
suppression.deleted
Suppression deleted
dns_error
domain.dns_error
DNS configuration error for a domain
sending_type_changed
domain.sending_type_changed
Sending type of a domain changed between transactional and marketing
contact_created
contact.created
Contact created
contact_updated
contact.updated
A field of a contact changed
contact_deleted
contact.deleted
Contact deleted
contact_added_to_list
contact.added_to_list
Contact added to a list
contact_removed_from_list
contact.removed_from_list
Contact removed from a list
contact_subscribed
contact.subscribed
Contact’s list subscription confirmed, or its unsubscribe from all lists cleared
contact_unsubscribed
contact.unsubscribed
Contact unsubscribed from a list, or from all lists
contact_complained
contact.complained
Contact reported a campaign email as spam
unsubscribed, complained, suppression_deleted and the contact events need CLI v0.4.0 or later, and sending_type_changed needs CLI v0.5.0 or later.--events can be given several times, and each value can hold several events separated by commas, so --events delivered,bounced is the same as --events delivered --events bounced. An unknown event, or the same event given twice (by its key, its type or both), fails with exit code 4 before any request.
Contact Events
The last eight events of the table are the contact events. They need an account with the marketing features, and an API key with the contacts:read scope, and lists:read as well for contact_added_to_list, contact_removed_from_list, contact_subscribed, contact_unsubscribed and contact_complained. The API checks the key for every event an enabled webhook has on, so a change to such a webhook needs these scopes even when it names no event. See contact events for what they report.On create, update and trigger, --all-events selects every event except the contact events: the 14 events any account can use. --all-contact-events selects the eight contact events. The two can be used together, and neither with --events. --all-contact-events needs CLI v0.4.0 or later.
Origins
A webhook’s origins pick whose changes its contact and suppression events report: recipient (the contact or recipient, through an unsubscribe or a spam complaint), api, dashboard or system (AhaSend). Message events, dns_error and sending_type_changed have no origin, and a webhook always gets them. See origin.--origins on create and update takes origins as --events takes events: several times, or separated by commas. Without it, create leaves the origins out, and the webhook gets every origin. On update, --origins replaces the origins, and --all-origins gives the webhook every origin again, since the API keeps the stored origins when a request names none; the two cannot be combined. --origins and --all-origins need CLI v0.4.0 or later.webhooks get shows the origins after the events, and CSV output has an origins column after events. For a webhook that gets every origin, table and plain output show all, and CSV output an empty cell. A table of webhooks has no origins column.
List Webhooks
# List all webhooksahasend webhooks list# List webhooks with JSON outputahasend webhooks list --output json# List only the enabled webhooksahasend webhooks list --enabled# List only the disabled webhooksahasend webhooks list --enabled=false# List only the webhooks that get contact.createdahasend webhooks list --events contact_created
--events lists only the webhooks that have every event it names on, and needs CLI v0.4.0 or later. The API applies the --enabled and --events filters, so a page holds up to --limit matching webhooks. Pages work as Lists and Pagination describes.
Create Webhook
# Create a webhook for three events of every domainahasend webhooks create \ --name "Main app webhook" \ --url https://app.example.com/webhooks/ahasend \ --scope global \ --events delivered,bounced,failed# Create a webhook for one domain, with every event except the contact eventsahasend webhooks create \ --name "Example webhook" \ --url https://api.example.com/webhooks/example \ --scope scoped --domains example.com \ --all-events# Create a webhook for the contact events of changes made through the APIahasend webhooks create \ --name "Contact sync" \ --url https://app.example.com/webhooks/contacts \ --all-contact-events --origins api# Create a disabled webhookahasend webhooks create \ --name "Test webhook" \ --url https://test.example.com/webhook \ --events delivered \ --enabled=false
--name and --url are required. When one is missing and stdin is a terminal, the command asks for it. With --non-interactive, or when stdin is not a terminal, a missing value fails with exit code 4.
On a terminal, without --events, --all-events or --all-contact-events, the command also asks for the events, and lists them. Answer with events separated by commas, or with all, which selects every event except the contact events, as --all-events does. A webhook created without events receives none until webhooks update gives it some.
--scope is global unless you set it. A global webhook receives the events of every domain. A scoped webhook receives only the events of the domains you give with --domains, which it requires. --domains without --scope scoped fails with exit code 4.
A webhook is enabled unless you set --enabled=false.
--url must be an HTTP or HTTPS URL with a host name and no user name or password. Use HTTPS in production: a plain HTTP URL for a host other than localhost or a loopback address prints a warning on stderr.
Show a webhook’s name, URL, status, events, origins, scope and domains, its timestamps and its call counters (successful calls, failed calls, errors since the last success and the last call time). The output has no secret: the API returns it only when you create the webhook.
ahasend webhooks get YOUR_RESOURCE_ID# Save the webhook's configuration as JSONahasend webhooks get YOUR_RESOURCE_ID --output json > webhook-backup.json
Update Webhook
Only the flags you set are sent, and other settings stay as they are, except that the event flags set the whole list of events (see the warning below). Give at least one flag.
# Change the name and URLahasend webhooks update YOUR_RESOURCE_ID \ --name "Updated webhook" \ --url https://new-endpoint.example.com/webhook# Enable the webhook and replace its eventsahasend webhooks update YOUR_RESOURCE_ID \ --enabled --events delivered,bounced,opened# Disable the webhookahasend webhooks update YOUR_RESOURCE_ID --enabled=false# Select every event, the contact events includedahasend webhooks update YOUR_RESOURCE_ID --all-events --all-contact-events# Remove every eventahasend webhooks update YOUR_RESOURCE_ID --clear-events# Get the contact and suppression events of changes made through the API onlyahasend webhooks update YOUR_RESOURCE_ID --origins api# Get them from every origin againahasend webhooks update YOUR_RESOURCE_ID --all-origins# Limit the webhook to two domainsahasend webhooks update YOUR_RESOURCE_ID \ --scope scoped --domains example.com,example.org# Remove the domain restrictionahasend webhooks update YOUR_RESOURCE_ID --scope global
On CLI v0.4.0 or later, the event flags set the webhook’s whole list of events: every event they do not name is turned off, including a contact event turned on in the dashboard. On CLI v0.5.0 or later, this includes sending_type_changed. To keep an event, name it too.
--events gives the webhook the events it names, and --all-events and --all-contact-events select events as Contact Events describes. --clear-events turns every event off, and cannot be combined with the other event flags.
--origins and --all-origins change the origins, as Origins describes.
--domains replaces the domains of a scoped webhook. The API ignores it on a global webhook unless you also give --scope scoped. --scope global --domains <domain> fails with exit code 4.
--scope global removes the domain restriction.
Delete Webhook
# Delete with a confirmation promptahasend webhooks delete YOUR_RESOURCE_ID# Skip the confirmation promptahasend webhooks delete YOUR_RESOURCE_ID --force
The command asks for confirmation first, as Prompts describes; --force (-f) skips it. A deleted webhook cannot be restored.
Listen for Events
webhooks listen streams webhook events to your terminal over a WebSocket connection, and can forward each event to a local endpoint. It prints events as text, whatever --output says, and runs until you press Ctrl+C or the connection closes.
# Listen through a temporary webhookahasend webhooks listen# Listen through an existing webhookahasend webhooks listen --webhook-id YOUR_RESOURCE_ID# Show only opens and clicks, and forward them to a local serverahasend webhooks listen \ --events message.opened,message.clicked \ --forward-to http://localhost:3000/webhook
The API key needs the webhooks:write:all scope. Without --webhook-id, the API creates a temporary webhook that stays after the command ends. Forwarded events are signed with a forwarding secret that the command prints when it connects. The webhook testing guide covers temporary webhooks, forwarding, signatures and exit codes.The stream sends only the events that the API key’s scopes can read. On CLI v0.4.0 or later, for each family of events the webhook turns on whose read scope the key does not have, the command prints the server’s warning on stderr as it connects, such as Warning: The API key does not have the suppressions:read scope, so suppression events are not sent to this stream.
Trigger Test Events
webhooks trigger asks the API to send test events to a webhook, so you can test your endpoint without waiting for real email events.
# Trigger one eventahasend webhooks trigger YOUR_RESOURCE_ID --events message.delivered# Trigger several eventsahasend webhooks trigger YOUR_RESOURCE_ID \ --events message.delivered,message.opened,message.clicked# Trigger every event except the contact eventsahasend webhooks trigger YOUR_RESOURCE_ID --all-events# Trigger the contact eventsahasend webhooks trigger YOUR_RESOURCE_ID --all-contact-events
Give --events, --all-events or --all-contact-events. --all-events and --all-contact-events together trigger all 22 events. Without an event flag, the command fails with exit code 4. The output is the API’s message. A disabled webhook gets no events: the API answers that they are queued, and then drops them. Enable the webhook first with ahasend webhooks update YOUR_RESOURCE_ID --enabled.
Command Flags
These flags come from the CLI’s --help. All commands also accept the global flags.
webhooks create
Flag
Description and default
--all-contact-events
Select every contact event
--all-events
Select every event except the contact events
--domains strings
Domain a scoped webhook is limited to (can be used multiple times)
--enabled
Enable the webhook (the API enables it when omitted) (default true)
--events strings
Event type, such as delivered or message.delivered (can be used multiple times)
--idempotency-key string
Idempotency key for safe retries (generated when omitted)
--name string
Webhook name (required)
--non-interactive
Never prompt; fail when a required flag is missing
--origins strings
Origin whose contact and suppression events the webhook gets: recipient, api, dashboard or system; every origin when not set (can be used multiple times)
--scope string
Webhook scope: global or scoped (default global)
--url string
Webhook URL (required)
webhooks delete
Flag
Description and default
-f, --force
Skip confirmation prompt
webhooks get
This command has no command-specific flags. See global flags.
webhooks list
Flag
Description and default
--after string
Return the page after this cursor
--before string
Return the page before this cursor
--enabled
Filter by enabled (--enabled) or disabled (--enabled=false) state
--events strings
List only the webhooks with this event on, such as delivered or message.delivered (can be used multiple times)
--limit int32
Maximum number of items to return (0-100; 0 uses the API default)
webhooks listen
Flag
Description and default
--events strings
Show only this event type, such as message.opened or opened (can be used multiple times)
--forward-to string
Local endpoint to forward events to
--skip-verify
Skip SSL certificate verification for local endpoints when forwarding events (needs --forward-to)
--slim-output
Slim down the payload for printing to the console
--webhook-id string
Use existing webhook instead of creating temporary one
webhooks trigger
Flag
Description and default
--all-contact-events
Select every contact event
--all-events
Select every event except the contact events
--events strings
Event type to trigger, such as message.delivered or delivered (can be used multiple times)
webhooks update
Flag
Description and default
--all-contact-events
Select every contact event
--all-events
Select every event except the contact events
--all-origins
Get the contact and suppression events of every origin
--clear-events
Remove every event type
--domains strings
Domain restriction, replacing all domains (can be used multiple times)
--enabled
Enable (--enabled) or disable (--enabled=false) the webhook
--events strings
Event type, such as delivered or message.delivered, replacing all event types (can be used multiple times)
--name string
New webhook name
--origins strings
Origin whose contact and suppression events the webhook gets: recipient, api, dashboard or system, replacing all origins (can be used multiple times)
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AhaSend","description":"AhaSend is a European transactional email service for developers: send through a REST API, SMTP relay, CLI or the official Node.js and Go SDKs, with data stored in the EU and 1,000 free emails per month.","colors":{"primary":"#066fd1","light":"#F8FAFC","dark":"#0F172A"},"logo":{"light":"https://mintcdn.com/ahasend/F35Ozd-1GsftDpcH/logo.png?fit=max\u0026auto=format\u0026n=F35Ozd-1GsftDpcH\u0026q=85\u0026s=ca1d4c27f7c2811598e65cb25a21323c","dark":"https://mintcdn.com/ahasend/F35Ozd-1GsftDpcH/logo-dark.png?fit=max\u0026auto=format\u0026n=F35Ozd-1GsftDpcH\u0026q=85\u0026s=bb6b9068b30f93fd1ea216e2a7c1d137","href":"https://ahasend.com/"},"favicon":"https://mintcdn.com/ahasend/F35Ozd-1GsftDpcH/favicon.png?fit=max\u0026auto=format\u0026n=F35Ozd-1GsftDpcH\u0026q=85\u0026s=ac855c16b6cb74b8c5965d2e7ef3e324","appearance":{"strict":false},"navbar":{"links":[{"href":"https://dash.ahasend.com","label":"Login"}],"primary":{"type":"button","label":"Get Started","href":"https://dash.ahasend.com/user/register"}},"footer":{"socials":{"x":"https://x.com/aha_send","linkedin":"https://www.linkedin.com/company/ahasend","github":"https://github.com/ahasend"},"links":[{"header":"Resources","items":[{"label":"Pricing","href":"https://ahasend.com/pricing"},{"label":"Support","href":"mailto:support@ahasend.com"},{"label":"Status","href":"https://status.ahasend.com"},{"label":"Security","href":"https://ahasend.com/security"}]},{"header":"Company","items":[{"label":"Blog","href":"https://ahasend.com/blog"},{"label":"Feedback Board","href":"https://ahasend.sleekplan.app/"}]},{"header":"Legal","items":[{"label":"Imprint","href":"https://ahasend.com/imprint"},{"label":"Terms of Service","href":"https://ahasend.com/terms"},{"label":"Privacy Policy","href":"https://ahasend.com/privacy"},{"label":"Data Processing Agreement","href":"https://ahasend.com/dpa"}]}]},"seo":{"metatags":{"canonical":"https://ahasend.com/docs","twitter:site":"@aha_send"},"organization":{"name":"AhaSend","legalName":"AhaSend B.V.","url":"https://ahasend.com","sameAs":["https://x.com/aha_send","https://www.linkedin.com/company/ahasend","https://github.com/ahasend"]}},"integrations":{"telemetry":{"enabled":true},"cookies":{"key":"cookieConsent","value":"true"}},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/ahasend/Gpf8BnLpzpIKQ4dU/images/social-background.svg?fit=max\u0026auto=format\u0026n=Gpf8BnLpzpIKQ4dU\u0026q=85\u0026s=df32e1edef517352b8437c75feecbf6e"},"markdown":{"instructions":["AhaSend stores all message data in the EU. See /facts.","The API base URL is https://api.ahasend.com. Send the API key in the Authorization: Bearer header. See /api-reference/authentication.","Use send.ahasend.com for SMTP. Ports 25, 587 and 2525 use STARTTLS. Port 465 is not supported. See /smtp.","For send-only integrations, create an API Key v2 under Credentials → Add and scope it to messages:send:{your-domain}. See /send-api/credentials and /api-reference/scopes."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ahasend","hasAudioNarration":false,"actualSubdomain":"ahasend","customDomains":["ahasend.com"],"gitSource":{"type":"github","owner":"ahasend","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6af4f3be7054b22400acdaa2","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"API Reference","count":150},{"language":"default","tag":"API reference","count":115},{"language":"default","tag":"Documentation","count":69},{"language":"default","tag":"Guides","count":52},{"language":"default","tag":"Integrations","count":41},{"language":"default","tag":"Webhooks","count":30},{"language":"default","tag":"CLI","count":26},{"language":"default","tag":"Commands","count":16},{"language":"default","tag":"Domain Authentication","count":13},{"language":"default","tag":"Campaigns","count":12}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":false}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#content-container table{display:table}#content-container table thead th{text-align:left}"},{"filePath":"roadmap.css","content":".rm{display:flex;flex-direction:column;gap:2.5rem;margin-top:1.5rem}.rm-head{display:flex;align-items:center;gap:0.65rem;margin-bottom:1rem}.rm-badge{display:inline-flex;align-items:center;margin:0;border:none;font-size:0.78rem;font-weight:600;letter-spacing:0.02em;padding:0.28rem 0.75rem;border-radius:999px;line-height:1}.rm-badge.is-active{background:#fdebd0;color:#854f0b}.rm-badge.is-planned{background:#e6f1fb;color:#0c447c}.rm-badge.is-shipped{background:#e1f5ee;color:#0f6e56}.rm-list{display:flex;flex-direction:column;gap:0.65rem}.rm-card{display:flex;gap:0.9rem;padding:0.9rem 1.05rem;background:#ffffff;border:1px solid #e5e7eb;border-radius:0.7rem;transition:transform 0.15s ease, box-shadow 0.15s ease}.rm-card:hover{transform:translateY(-1px);box-shadow:0 4px 14px rgba(0, 0, 0, 0.06)}.rm-accent{flex:0 0 3px;border-radius:2px}.rm-card.is-active .rm-accent{background:#ba7517}.rm-card.is-planned .rm-accent{background:#378add}.rm-card.is-shipped .rm-accent{background:#1d9e75}.rm-card.is-sub{margin-left:2rem;position:relative}.rm-card.is-sub .rm-title{font-size:0.9rem}.rm-card.is-sub::before{content:\"\";position:absolute;left:-1.15rem;top:-0.65rem;height:calc(100% + 0.65rem);border-left:1.5px solid #d1d5db;pointer-events:none}.rm-card.is-sub::after{content:\"\";position:absolute;left:-1.15rem;top:50%;width:0.85rem;border-top:1.5px solid #d1d5db;pointer-events:none}.rm-card .rm-title{margin:0 0 0.2rem;font-size:0.97rem;font-weight:600;line-height:1.35;color:#111827}.rm-card p{margin:0;font-size:0.9rem;line-height:1.55;color:#4b5563}.rm-date{display:inline-block;margin-top:0.5rem;font-size:0.78rem;font-weight:600;color:#0f6e56}.rm-tag{display:inline-block;margin-left:0.5rem;font-size:0.66rem;font-weight:700;letter-spacing:0.04em;text-transform:uppercase;padding:0.16rem 0.5rem;border-radius:999px;vertical-align:middle;line-height:1.4;color:#fff;box-shadow:0 1px 2px rgba(0, 0, 0, 0.15)}.rm-tag.is-new{background:#6d28d9}.rm-tag.is-product{background:#be123c}.rm-tag.is-improvement{background:#0e7490}.rm-tag.is-early{background:#1d4ed8}.rm-tag.is-bugfix{background:#c2410c}.dark .rm-card{background:rgba(255, 255, 255, 0.025);border-color:rgba(255, 255, 255, 0.09)}.dark .rm-card p{color:#9ca3af}.dark .rm-badge.is-active{background:rgba(186, 117, 23, 0.18);color:#fac074}.dark .rm-badge.is-planned{background:rgba(55, 138, 221, 0.18);color:#85b7eb}.dark .rm-badge.is-shipped{background:rgba(29, 158, 117, 0.18);color:#5dcaa5}.dark .rm-date{color:#5dcaa5}.dark .rm-card.is-sub::before,.dark .rm-card.is-sub::after{border-color:rgba(255, 255, 255, 0.18)}.rm-note{margin-top:2.5rem;font-size:0.85rem;color:#6b7280}.dark .rm-note{color:#9ca3af}.dark .rm-card .rm-title{color:#e7e9ee}.rm-jump{margin:-0.5rem 0 0;font-size:0.88rem}.rm-jump a{color:#2296FF;text-decoration:none;font-weight:500}.rm-jump a:hover{text-decoration:underline}.rm-badge[id]{scroll-margin-top:6rem}"}],"page":{"pagePath":"cli/commands/webhooks","slug":"/cli/commands/webhooks","pageMetadata":{"title":"ahasend webhooks: Manage and Test Webhooks","description":"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.","icon":"webhook","sidebarTitle":"webhooks","href":"/cli/commands/webhooks"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`AhaSend CLI `,_jsx(_components.code,{children:`webhooks`}),` commands let you manage, forward and trigger email event webhooks; this page lists their arguments and flags. For the complete local testing workflow, use the `,_jsx(_components.a,{href:`/cli/webhook-testing`,children:`webhook testing guide`}),`. For dashboard setup, see `,_jsx(_components.a,{href:`/integrations/webhooks`,children:`the webhooks guide`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`Before running the examples, `,_jsx(_components.a,{href:`/cli/authentication`,children:`log in`}),` with an API key that has the read, write and delete `,_jsx(_components.a,{href:`/api-reference/scopes#webhook-management`,children:`webhook scopes`}),` for all domains, and replace `,_jsx(_components.code,{children:`YOUR_RESOURCE_ID`}),` with the ID of one of your webhooks. In the `,_jsx(_components.code,{children:`--domains`}),` examples, replace `,_jsx(_components.code,{children:`example.com`}),` and `,_jsx(_components.code,{children:`example.org`}),` with domains in your account; for any other domain, the API answers 400 `,_jsx(_components.code,{children:`invalid domain: \u003cdomain>`}),`. The contact event examples need the scopes and the account that `,_jsx(_components.a,{href:`#contact-events`,children:`contact events`}),` describes.`]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`ahasend webhooks [subcommand] [flags]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Available subcommands:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`list`}),` - List webhooks`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`create`}),` - Create a webhook`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`get`}),` - Get a webhook`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`update`}),` - Update a webhook`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`delete`}),` - Delete a webhook`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`listen`}),` - Listen for webhook events in real-time`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`trigger`}),` - Trigger webhook events for testing`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`webhooks get`}),`, `,_jsx(_components.code,{children:`webhooks update`}),`, `,_jsx(_components.code,{children:`webhooks delete`}),` and `,_jsx(_components.code,{children:`webhooks trigger`}),` take the webhook ID as their positional argument. A webhook ID that is not a UUID fails with exit code 4 before any request. Find IDs with `,_jsx(_components.code,{children:`ahasend webhooks list`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`event-types`,children:`Event Types`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--events`}),` on `,_jsx(_components.code,{children:`list`}),`, `,_jsx(_components.code,{children:`create`}),`, `,_jsx(_components.code,{children:`update`}),`, `,_jsx(_components.code,{children:`listen`}),` and `,_jsx(_components.code,{children:`trigger`}),` takes each event by its key or by its type, such as `,_jsx(_components.code,{children:`delivered`}),` or `,_jsx(_components.code,{children:`message.delivered`}),`. See the `,_jsx(_components.a,{href:`/api-reference/webhooks`,children:`event reference`}),` for the payloads.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Event key`}),_jsx(_components.th,{children:`Event type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`reception`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.reception`})}),_jsx(_components.td,{children:`Email received by AhaSend`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`delivered`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.delivered`})}),_jsx(_components.td,{children:`Email delivered to recipient`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`transient_error`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.transient_error`})}),_jsx(_components.td,{children:`Temporary delivery failure`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`failed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.failed`})}),_jsx(_components.td,{children:`Permanent delivery failure`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`bounced`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.bounced`})}),_jsx(_components.td,{children:`Email bounced`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`suppressed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.suppressed`})}),_jsx(_components.td,{children:`Email suppressed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`opened`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.opened`})}),_jsx(_components.td,{children:`Email opened by recipient`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`clicked`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.clicked`})}),_jsx(_components.td,{children:`Link clicked in email`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`unsubscribed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.unsubscribed`})}),_jsx(_components.td,{children:`Recipient unsubscribed through a campaign email`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`complained`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`message.complained`})}),_jsx(_components.td,{children:`Campaign email reported as spam`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`suppression_created`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`suppression.created`})}),_jsx(_components.td,{children:`New suppression added`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`suppression_deleted`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`suppression.deleted`})}),_jsx(_components.td,{children:`Suppression deleted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`dns_error`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`domain.dns_error`})}),_jsx(_components.td,{children:`DNS configuration error for a domain`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`sending_type_changed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`domain.sending_type_changed`})}),_jsx(_components.td,{children:`Sending type of a domain changed between transactional and marketing`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_created`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.created`})}),_jsx(_components.td,{children:`Contact created`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_updated`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.updated`})}),_jsx(_components.td,{children:`A field of a contact changed`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_deleted`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.deleted`})}),_jsx(_components.td,{children:`Contact deleted`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_added_to_list`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.added_to_list`})}),_jsx(_components.td,{children:`Contact added to a list`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_removed_from_list`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.removed_from_list`})}),_jsx(_components.td,{children:`Contact removed from a list`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_subscribed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.subscribed`})}),_jsx(_components.td,{children:`Contact’s list subscription confirmed, or its unsubscribe from all lists cleared`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_unsubscribed`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.unsubscribed`})}),_jsx(_components.td,{children:`Contact unsubscribed from a list, or from all lists`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`contact_complained`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`contact.complained`})}),_jsx(_components.td,{children:`Contact reported a campaign email as spam`})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`unsubscribed`}),`, `,_jsx(_components.code,{children:`complained`}),`, `,_jsx(_components.code,{children:`suppression_deleted`}),` and the contact events need CLI v0.4.0 or later, and `,_jsx(_components.code,{children:`sending_type_changed`}),` needs CLI v0.5.0 or later.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--events`}),` can be given several times, and each value can hold several events separated by commas, so `,_jsx(_components.code,{children:`--events delivered,bounced`}),` is the same as `,_jsx(_components.code,{children:`--events delivered --events bounced`}),`. An unknown event, or the same event given twice (by its key, its type or both), fails with exit code 4 before any request.`]}),`\n`,_jsx(Heading,{level:`3`,id:`contact-events`,children:`Contact Events`}),`\n`,_jsxs(_components.p,{children:[`The last eight events of the table are the contact events. They need an account with the marketing features, and an API key with the `,_jsx(_components.code,{children:`contacts:read`}),` scope, and `,_jsx(_components.code,{children:`lists:read`}),` as well for `,_jsx(_components.code,{children:`contact_added_to_list`}),`, `,_jsx(_components.code,{children:`contact_removed_from_list`}),`, `,_jsx(_components.code,{children:`contact_subscribed`}),`, `,_jsx(_components.code,{children:`contact_unsubscribed`}),` and `,_jsx(_components.code,{children:`contact_complained`}),`. The API checks the key for every event an enabled webhook has on, so a change to such a webhook needs these scopes even when it names no event. See `,_jsx(_components.a,{href:`/api-reference/webhooks#contact-events`,children:`contact events`}),` for what they report.`]}),`\n`,_jsxs(_components.p,{children:[`On `,_jsx(_components.code,{children:`create`}),`, `,_jsx(_components.code,{children:`update`}),` and `,_jsx(_components.code,{children:`trigger`}),`, `,_jsx(_components.code,{children:`--all-events`}),` selects every event except the contact events: the 14 events any account can use. `,_jsx(_components.code,{children:`--all-contact-events`}),` selects the eight contact events. The two can be used together, and neither with `,_jsx(_components.code,{children:`--events`}),`. `,_jsx(_components.code,{children:`--all-contact-events`}),` needs CLI v0.4.0 or later.`]}),`\n`,_jsx(Heading,{level:`2`,id:`origins`,children:`Origins`}),`\n`,_jsxs(_components.p,{children:[`A webhook’s origins pick whose changes its contact and suppression events report: `,_jsx(_components.code,{children:`recipient`}),` (the contact or recipient, through an unsubscribe or a spam complaint), `,_jsx(_components.code,{children:`api`}),`, `,_jsx(_components.code,{children:`dashboard`}),` or `,_jsx(_components.code,{children:`system`}),` (AhaSend). Message events, `,_jsx(_components.code,{children:`dns_error`}),` and `,_jsx(_components.code,{children:`sending_type_changed`}),` have no origin, and a webhook always gets them. See `,_jsx(_components.a,{href:`/api-reference/webhooks#origin`,children:`origin`}),`.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--origins`}),` on `,_jsx(_components.code,{children:`create`}),` and `,_jsx(_components.code,{children:`update`}),` takes origins as `,_jsx(_components.code,{children:`--events`}),` takes events: several times, or separated by commas. Without it, `,_jsx(_components.code,{children:`create`}),` leaves the origins out, and the webhook gets every origin. On `,_jsx(_components.code,{children:`update`}),`, `,_jsx(_components.code,{children:`--origins`}),` replaces the origins, and `,_jsx(_components.code,{children:`--all-origins`}),` gives the webhook every origin again, since the API keeps the stored origins when a request names none; the two cannot be combined. `,_jsx(_components.code,{children:`--origins`}),` and `,_jsx(_components.code,{children:`--all-origins`}),` need CLI v0.4.0 or later.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`webhooks get`}),` shows the origins after the events, and CSV output has an `,_jsx(_components.code,{children:`origins`}),` column after `,_jsx(_components.code,{children:`events`}),`. For a webhook that gets every origin, table and plain output show `,_jsx(_components.code,{children:`all`}),`, and CSV output an empty cell. A table of webhooks has no origins column.`]}),`\n`,_jsx(Heading,{level:`2`,id:`list-webhooks`,children:`List Webhooks`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# List all webhooks`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# List webhooks with JSON output`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` json`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# List only the enabled webhooks`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --enabled`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# List only the disabled webhooks`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --enabled=false`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# List only the webhooks that get contact.created`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --events`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` contact_created`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`--events`}),` lists only the webhooks that have every event it names on, and needs CLI v0.4.0 or later. The API applies the `,_jsx(_components.code,{children:`--enabled`}),` and `,_jsx(_components.code,{children:`--events`}),` filters, so a page holds up to `,_jsx(_components.code,{children:`--limit`}),` matching webhooks. Pages work as `,_jsx(_components.a,{href:`/cli/configuration#lists-and-pagination`,children:`Lists and Pagination`}),` describes.`]}),`\n`,_jsx(Heading,{level:`2`,id:`create-webhook`,children:`Create Webhook`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`26`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`26`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Create a webhook for three events of every domain`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Main app webhook\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://app.example.com/webhooks/ahasend`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` global`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --events`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` delivered,bounced,failed`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Create a webhook for one domain, with every event except the contact events`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Example webhook\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.example.com/webhooks/example`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` scoped`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --domains`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` example.com`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-events`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Create a webhook for the contact events of changes made through the API`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Contact sync\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://app.example.com/webhooks/contacts`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-contact-events`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --origins`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` api`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Create a disabled webhook`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Test webhook\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://test.example.com/webhook`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --events`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` delivered`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --enabled=false`})}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--name`}),` and `,_jsx(_components.code,{children:`--url`}),` are required. When one is missing and stdin is a terminal, the command asks for it. With `,_jsx(_components.code,{children:`--non-interactive`}),`, or when stdin is not a terminal, a missing value fails with exit code 4.`]}),`\n`,_jsxs(_components.li,{children:[`On a terminal, without `,_jsx(_components.code,{children:`--events`}),`, `,_jsx(_components.code,{children:`--all-events`}),` or `,_jsx(_components.code,{children:`--all-contact-events`}),`, the command also asks for the events, and lists them. Answer with events separated by commas, or with `,_jsx(_components.code,{children:`all`}),`, which selects every event except the contact events, as `,_jsx(_components.code,{children:`--all-events`}),` does. A webhook created without events receives none until `,_jsx(_components.code,{children:`webhooks update`}),` gives it some.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--scope`}),` is `,_jsx(_components.code,{children:`global`}),` unless you set it. A global webhook receives the events of every domain. A `,_jsx(_components.code,{children:`scoped`}),` webhook receives only the events of the domains you give with `,_jsx(_components.code,{children:`--domains`}),`, which it requires. `,_jsx(_components.code,{children:`--domains`}),` without `,_jsx(_components.code,{children:`--scope scoped`}),` fails with exit code 4.`]}),`\n`,_jsxs(_components.li,{children:[`A webhook is enabled unless you set `,_jsx(_components.code,{children:`--enabled=false`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--url`}),` must be an HTTP or HTTPS URL with a host name and no user name or password. Use HTTPS in production: a plain HTTP URL for a host other than `,_jsx(_components.code,{children:`localhost`}),` or a loopback address prints a warning on stderr.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The output shows the webhook’s secret once. Save it to `,_jsx(_components.a,{href:`/api-reference/webhooks/security`,children:`verify the webhook’s signatures`}),`; `,_jsx(_components.code,{children:`webhooks get`}),` does not show it.`]}),`\n`,_jsx(Heading,{level:`2`,id:`get-webhook`,children:`Get Webhook`}),`\n`,_jsx(_components.p,{children:`Show a webhook’s name, URL, status, events, origins, scope and domains, its timestamps and its call counters (successful calls, failed calls, errors since the last success and the last call time). The output has no secret: the API returns it only when you create the webhook.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Save the webhook's configuration as JSON`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` get`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` >`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhook-backup.json`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`update-webhook`,children:`Update Webhook`}),`\n`,_jsx(_components.p,{children:`Only the flags you set are sent, and other settings stay as they are, except that the event flags set the whole list of events (see the warning below). Give at least one flag.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`30`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`30`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Change the name and URL`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Updated webhook\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://new-endpoint.example.com/webhook`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Enable the webhook and replace its events`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --enabled`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --events`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` delivered,bounced,opened`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Disable the webhook`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --enabled=false`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Select every event, the contact events included`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-events`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-contact-events`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Remove every event`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --clear-events`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Get the contact and suppression events of changes made through the API only`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --origins`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` api`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Get them from every origin again`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-origins`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Limit the webhook to two domains`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` scoped`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --domains`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` example.com,example.org`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Remove the domain restriction`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` global`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`On CLI v0.4.0 or later, the event flags set the webhook’s whole list of events: every event they do not name is turned off, including a contact event turned on in the dashboard. On CLI v0.5.0 or later, this includes `,_jsx(_components.code,{children:`sending_type_changed`}),`. To keep an event, name it too.`]})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--events`}),` gives the webhook the events it names, and `,_jsx(_components.code,{children:`--all-events`}),` and `,_jsx(_components.code,{children:`--all-contact-events`}),` select events as `,_jsx(_components.a,{href:`#contact-events`,children:`Contact Events`}),` describes. `,_jsx(_components.code,{children:`--clear-events`}),` turns every event off, and cannot be combined with the other event flags.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--origins`}),` and `,_jsx(_components.code,{children:`--all-origins`}),` change the origins, as `,_jsx(_components.a,{href:`#origins`,children:`Origins`}),` describes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--domains`}),` replaces the domains of a scoped webhook. The API ignores it on a global webhook unless you also give `,_jsx(_components.code,{children:`--scope scoped`}),`. `,_jsx(_components.code,{children:`--scope global --domains \u003cdomain>`}),` fails with exit code 4.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--scope global`}),` removes the domain restriction.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`delete-webhook`,children:`Delete Webhook`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Delete with a confirmation prompt`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` delete`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Skip the confirmation prompt`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` delete`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --force`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The command asks for confirmation first, as `,_jsx(_components.a,{href:`/cli/configuration#prompts`,children:`Prompts`}),` describes; `,_jsx(_components.code,{children:`--force`}),` (`,_jsx(_components.code,{children:`-f`}),`) skips it. A deleted webhook cannot be restored.`]}),`\n`,_jsx(Heading,{level:`2`,id:`listen-for-events`,children:`Listen for Events`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`webhooks listen`}),` streams webhook events to your terminal over a WebSocket connection, and can forward each event to a local endpoint. It prints events as text, whatever `,_jsx(_components.code,{children:`--output`}),` says, and runs until you press Ctrl+C or the connection closes.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Listen through a temporary webhook`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` listen`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Listen through an existing webhook`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` listen`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --webhook-id`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Show only opens and clicks, and forward them to a local server`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` listen`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --events`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` message.opened,message.clicked`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --forward-to`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` http://localhost:3000/webhook`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The API key needs the `,_jsx(_components.code,{children:`webhooks:write:all`}),` scope. Without `,_jsx(_components.code,{children:`--webhook-id`}),`, the API creates a temporary webhook that stays after the command ends. Forwarded events are signed with a forwarding secret that the command prints when it connects. The `,_jsx(_components.a,{href:`/cli/webhook-testing`,children:`webhook testing guide`}),` covers temporary webhooks, forwarding, signatures and exit codes.`]}),`\n`,_jsxs(_components.p,{children:[`The stream sends only the events that the API key’s scopes can read. On CLI v0.4.0 or later, for each family of events the webhook turns on whose read scope the key does not have, the command prints the server’s warning on stderr as it connects, such as `,_jsx(_components.code,{children:`Warning: The API key does not have the suppressions:read scope, so suppression events are not sent to this stream`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`trigger-test-events`,children:`Trigger Test Events`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`webhooks trigger`}),` asks the API to send test events to a webhook, so you can test your endpoint without waiting for real email events.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`12`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Trigger one event`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` trigger`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --events`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` message.delivered`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Trigger several events`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` trigger`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --events`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` message.delivered,message.opened,message.clicked`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Trigger every event except the contact events`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` trigger`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-events`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Trigger the contact events`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`ahasend`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` webhooks`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` trigger`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` YOUR_RESOURCE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --all-contact-events`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Give `,_jsx(_components.code,{children:`--events`}),`, `,_jsx(_components.code,{children:`--all-events`}),` or `,_jsx(_components.code,{children:`--all-contact-events`}),`. `,_jsx(_components.code,{children:`--all-events`}),` and `,_jsx(_components.code,{children:`--all-contact-events`}),` together trigger all 22 events. Without an event flag, the command fails with exit code 4. The output is the API’s message. A disabled webhook gets no events: the API answers that they are queued, and then drops them. Enable the webhook first with `,_jsx(_components.code,{children:`ahasend webhooks update YOUR_RESOURCE_ID --enabled`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`command-flags`,children:`Command Flags`}),`\n`,_jsxs(_components.p,{children:[`These flags come from the CLI’s `,_jsx(_components.code,{children:`--help`}),`. All commands also accept the `,_jsx(_components.a,{href:`/cli/configuration#global-flags`,children:`global flags`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`webhooks-create`,children:_jsx(_components.code,{children:`webhooks create`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description and default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all-contact-events`})}),_jsx(_components.td,{children:`Select every contact event`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all-events`})}),_jsx(_components.td,{children:`Select every event except the contact events`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--domains strings`})}),_jsx(_components.td,{children:`Domain a scoped webhook is limited to (can be used multiple times)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--enabled`})}),_jsx(_components.td,{children:`Enable the webhook (the API enables it when omitted) (default true)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--events strings`})}),_jsxs(_components.td,{children:[`Event type, such as `,_jsx(_components.code,{children:`delivered`}),` or `,_jsx(_components.code,{children:`message.delivered`}),` (can be used multiple times)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--idempotency-key string`})}),_jsx(_components.td,{children:`Idempotency key for safe retries (generated when omitted)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--name string`})}),_jsx(_components.td,{children:`Webhook name (required)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--non-interactive`})}),_jsx(_components.td,{children:`Never prompt; fail when a required flag is missing`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--origins strings`})}),_jsxs(_components.td,{children:[`Origin whose contact and suppression events the webhook gets: `,_jsx(_components.code,{children:`recipient`}),`, `,_jsx(_components.code,{children:`api`}),`, `,_jsx(_components.code,{children:`dashboard`}),` or `,_jsx(_components.code,{children:`system`}),`; every origin when not set (can be used multiple times)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--scope string`})}),_jsxs(_components.td,{children:[`Webhook scope: `,_jsx(_components.code,{children:`global`}),` or `,_jsx(_components.code,{children:`scoped`}),` (default `,_jsx(_components.code,{children:`global`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--url string`})}),_jsx(_components.td,{children:`Webhook URL (required)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`webhooks-delete`,children:_jsx(_components.code,{children:`webhooks delete`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description and default`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`-f`}),`, `,_jsx(_components.code,{children:`--force`})]}),_jsx(_components.td,{children:`Skip confirmation prompt`})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`webhooks-get`,children:_jsx(_components.code,{children:`webhooks get`})}),`\n`,_jsxs(_components.p,{children:[`This command has no command-specific flags. See `,_jsx(_components.a,{href:`/cli/configuration#global-flags`,children:`global flags`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`webhooks-list`,children:_jsx(_components.code,{children:`webhooks list`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description and default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--after string`})}),_jsx(_components.td,{children:`Return the page after this cursor`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--before string`})}),_jsx(_components.td,{children:`Return the page before this cursor`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--enabled`})}),_jsxs(_components.td,{children:[`Filter by enabled (`,_jsx(_components.code,{children:`--enabled`}),`) or disabled (`,_jsx(_components.code,{children:`--enabled=false`}),`) state`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--events strings`})}),_jsxs(_components.td,{children:[`List only the webhooks with this event on, such as `,_jsx(_components.code,{children:`delivered`}),` or `,_jsx(_components.code,{children:`message.delivered`}),` (can be used multiple times)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--limit int32`})}),_jsx(_components.td,{children:`Maximum number of items to return (0-100; 0 uses the API default)`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`webhooks-listen`,children:_jsx(_components.code,{children:`webhooks listen`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description and default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--events strings`})}),_jsxs(_components.td,{children:[`Show only this event type, such as `,_jsx(_components.code,{children:`message.opened`}),` or `,_jsx(_components.code,{children:`opened`}),` (can be used multiple times)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--forward-to string`})}),_jsx(_components.td,{children:`Local endpoint to forward events to`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--skip-verify`})}),_jsxs(_components.td,{children:[`Skip SSL certificate verification for local endpoints when forwarding events (needs `,_jsx(_components.code,{children:`--forward-to`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--slim-output`})}),_jsx(_components.td,{children:`Slim down the payload for printing to the console`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--webhook-id string`})}),_jsx(_components.td,{children:`Use existing webhook instead of creating temporary one`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`webhooks-trigger`,children:_jsx(_components.code,{children:`webhooks trigger`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description and default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all-contact-events`})}),_jsx(_components.td,{children:`Select every contact event`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all-events`})}),_jsx(_components.td,{children:`Select every event except the contact events`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--events strings`})}),_jsxs(_components.td,{children:[`Event type to trigger, such as `,_jsx(_components.code,{children:`message.delivered`}),` or `,_jsx(_components.code,{children:`delivered`}),` (can be used multiple times)`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`webhooks-update`,children:_jsx(_components.code,{children:`webhooks update`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Flag`}),_jsx(_components.th,{children:`Description and default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all-contact-events`})}),_jsx(_components.td,{children:`Select every contact event`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all-events`})}),_jsx(_components.td,{children:`Select every event except the contact events`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--all-origins`})}),_jsx(_components.td,{children:`Get the contact and suppression events of every origin`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--clear-events`})}),_jsx(_components.td,{children:`Remove every event type`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--domains strings`})}),_jsx(_components.td,{children:`Domain restriction, replacing all domains (can be used multiple times)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--enabled`})}),_jsxs(_components.td,{children:[`Enable (`,_jsx(_components.code,{children:`--enabled`}),`) or disable (`,_jsx(_components.code,{children:`--enabled=false`}),`) the webhook`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--events strings`})}),_jsxs(_components.td,{children:[`Event type, such as `,_jsx(_components.code,{children:`delivered`}),` or `,_jsx(_components.code,{children:`message.delivered`}),`, replacing all event types (can be used multiple times)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--name string`})}),_jsx(_components.td,{children:`New webhook name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--origins strings`})}),_jsxs(_components.td,{children:[`Origin whose contact and suppression events the webhook gets: `,_jsx(_components.code,{children:`recipient`}),`, `,_jsx(_components.code,{children:`api`}),`, `,_jsx(_components.code,{children:`dashboard`}),` or `,_jsx(_components.code,{children:`system`}),`, replacing all origins (can be used multiple times)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--scope string`})}),_jsxs(_components.td,{children:[`New webhook scope: `,_jsx(_components.code,{children:`global`}),` or `,_jsx(_components.code,{children:`scoped`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`--url string`})}),_jsx(_components.td,{children:`New webhook URL`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`related-guides`,children:`Related Guides`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/cli/installation`,children:`Install the CLI`}),`, `,_jsx(_components.a,{href:`/cli/authentication`,children:`CLI authentication`}),`, `,_jsx(_components.a,{href:`/integrations/webhooks`,children:`Webhook setup`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/webhooks`,children:`Event reference`}),`, `,_jsx(_components.a,{href:`/cli/webhook-testing`,children:`Local webhook testing`}),`, `,_jsx(_components.a,{href:`/api-reference/webhooks/security`,children:`Signature verification`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/webhooks/retry-policy`,children:`Retry policy`}),`, `,_jsx(_components.a,{href:`/cli/configuration`,children:`CLI configuration and output`}),`, `,_jsx(_components.a,{href:`/api-reference/authentication`,children:`API authentication`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`/api-reference/scopes`,children:`Permission scopes`}),`, `,_jsx(_components.a,{href:`/bounces#suppression-duration`,children:`Suppression durations`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"ahasend webhooks: Manage and Test Webhooks","description":"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.","icon":"webhook","sidebarTitle":"webhooks","href":"/cli/commands/webhooks"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Event Types","slug":"event-types","depth":2,"children":[{"title":"Contact Events","slug":"contact-events","depth":3,"children":[]}]},{"title":"Origins","slug":"origins","depth":2,"children":[]},{"title":"List Webhooks","slug":"list-webhooks","depth":2,"children":[]},{"title":"Create Webhook","slug":"create-webhook","depth":2,"children":[]},{"title":"Get Webhook","slug":"get-webhook","depth":2,"children":[]},{"title":"Update Webhook","slug":"update-webhook","depth":2,"children":[]},{"title":"Delete Webhook","slug":"delete-webhook","depth":2,"children":[]},{"title":"Listen for Events","slug":"listen-for-events","depth":2,"children":[]},{"title":"Trigger Test Events","slug":"trigger-test-events","depth":2,"children":[]},{"title":"Command Flags","slug":"command-flags","depth":2,"children":[{"title":"webhooks create","slug":"webhooks-create","depth":3,"children":[]},{"title":"webhooks delete","slug":"webhooks-delete","depth":3,"children":[]},{"title":"webhooks get","slug":"webhooks-get","depth":3,"children":[]},{"title":"webhooks list","slug":"webhooks-list","depth":3,"children":[]},{"title":"webhooks listen","slug":"webhooks-listen","depth":3,"children":[]},{"title":"webhooks trigger","slug":"webhooks-trigger","depth":3,"children":[]},{"title":"webhooks update","slug":"webhooks-update","depth":3,"children":[]}]},{"title":"Related Guides","slug":"related-guides","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/ahasend/2374706ad872d133/ahasend-utm.js"],"subdomain":"ahasend","siteName":"AhaSend","title":"ahasend webhooks: Manage and Test Webhooks - AhaSend","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-11T22:53:17.775Z","originalFileLocation":"cli/commands/webhooks.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AhaSend\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ahasend webhooks: Manage and Test Webhooks - AhaSend\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AhaSend\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://ahasend.com/docs/cli/commands/webhooks\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ahasend.mintlify.site/docs/_mintlify/api/og/v2?division=Commands\u0026amp;title=ahasend+webhooks%3A+Manage+and+Test+Webhooks\u0026amp;description=Create%2C+update%2C+and+delete+AhaSend+email+event+webhooks+from+the+CLI%2C+and+test+them+locally+with+webhooks+listen+%28forward+to+localhost%29+and+webhooks+trigger.\u0026amp;theme=3bb0eae7085462f4939923a7\u0026amp;signature=2bfefadedc79b241e37a3fb16f9119176cc36e90a69131d35008a6b6eb9a1fad\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ahasend webhooks: Manage and Test Webhooks - AhaSend\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ahasend.mintlify.site/docs/_mintlify/api/og/v2?division=Commands\u0026amp;title=ahasend+webhooks%3A+Manage+and+Test+Webhooks\u0026amp;description=Create%2C+update%2C+and+delete+AhaSend+email+event+webhooks+from+the+CLI%2C+and+test+them+locally+with+webhooks+listen+%28forward+to+localhost%29+and+webhooks+trigger.\u0026amp;theme=3bb0eae7085462f4939923a7\u0026amp;signature=2bfefadedc79b241e37a3fb16f9119176cc36e90a69131d35008a6b6eb9a1fad\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/ahasend/4BjAcdwrGYDKJCaO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AhaSend\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#066fd1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://ahasend.com/docs/cli/commands/webhooks\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/cli/commands/webhooks.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://ahasend.com/#organization\",\"name\":\"AhaSend\",\"legalName\":\"AhaSend B.V.\",\"url\":\"https://ahasend.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ahasend/F35Ozd-1GsftDpcH/logo.png?fit=max\u0026auto=format\u0026n=F35Ozd-1GsftDpcH\u0026q=85\u0026s=ca1d4c27f7c2811598e65cb25a21323c\"},\"sameAs\":[\"https://x.com/aha_send\",\"https://www.linkedin.com/company/ahasend\",\"https://github.com/ahasend\"]},{\"@type\":\"WebSite\",\"@id\":\"https://ahasend.com/docs#website\",\"name\":\"AhaSend\",\"url\":\"https://ahasend.com/docs\",\"publisher\":{\"@id\":\"https://ahasend.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://ahasend.com/docs/cli/commands/webhooks#webpage\",\"url\":\"https://ahasend.com/docs/cli/commands/webhooks\",\"name\":\"ahasend webhooks: Manage and Test Webhooks\",\"description\":\"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.\",\"dateModified\":\"2026-11-11T22:53:17.775Z\",\"isPartOf\":{\"@id\":\"https://ahasend.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://ahasend.com/docs/cli/commands/webhooks#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://ahasend.com/docs/cli/commands/webhooks#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Commands\",\"item\":\"https://ahasend.com/docs/cli/commands/messages\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ahasend webhooks: Manage and Test Webhooks\",\"item\":\"https://ahasend.com/docs/cli/commands/webhooks\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://ahasend.com/docs/cli/commands/webhooks#article\",\"headline\":\"ahasend webhooks: Manage and Test Webhooks\",\"name\":\"ahasend webhooks: Manage and Test Webhooks\",\"description\":\"Create, update, and delete AhaSend email event webhooks from the CLI, and test them locally with webhooks listen (forward to localhost) and webhooks trigger.\",\"url\":\"https://ahasend.com/docs/cli/commands/webhooks\",\"mainEntityOfPage\":{\"@id\":\"https://ahasend.com/docs/cli/commands/webhooks#webpage\"},\"dateModified\":\"2026-11-11T22:53:17.775Z\",\"publisher\":{\"@id\":\"https://ahasend.com/#organization\"},\"isPartOf\":{\"@id\":\"https://ahasend.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AhaSend\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"AhaSend\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/cli/commands/webhooks.md","siteName":"AhaSend","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference"}]},{"tab":"CLI","icon":"square-terminal","groups":[{"group":"Getting Started","pages":[{"title":"AhaSend CLI: Send Email from Your Terminal","icon":"book","sidebarTitle":"Overview","href":"/cli"},{"title":"Install the AhaSend CLI (macOS, Linux, Windows)","icon":"download","sidebarTitle":"Installation","href":"/cli/installation"},{"title":"CLI Quickstart: Send Email from the Terminal","icon":"play","sidebarTitle":"Quickstart","href":"/cli/quickstart"},{"title":"CLI Authentication: API Keys and Profiles","icon":"key","sidebarTitle":"Authentication","href":"/cli/authentication"},{"title":"CLI Configuration: Config File, Flags, Output","icon":"gear","sidebarTitle":"Configuration","href":"/cli/configuration"},{"title":"CLI Examples: Scripts and CI/CD Automation","icon":"lightbulb","sidebarTitle":"Examples","href":"/cli/examples"}]},{"group":"Commands","pages":[{"title":"ahasend messages: Send and Track Email","icon":"envelope","sidebarTitle":"messages","href":"/cli/commands/messages"},{"title":"ahasend domains: Add and Verify Domains","description":"Add, verify, update, and delete AhaSend sending domains from the command line, and export their DNS records as BIND, Cloudflare, or Terraform.","icon":"globe","sidebarTitle":"domains","href":"/cli/commands/domains"},{"title":"ahasend webhooks: Manage and Test Webhooks","icon":"webhook","sidebarTitle":"webhooks","href":"/cli/commands/webhooks"},{"title":"ahasend routes: Manage Inbound Email Routes","description":"Create and manage AhaSend inbound email routes from the CLI: match recipients, POST parsed emails to your webhook, and test locally with routes listen.","icon":"route","sidebarTitle":"routes","href":"/cli/commands/routes"},{"title":"ahasend suppressions: Manage Suppressions","icon":"ban","sidebarTitle":"suppressions","href":"/cli/commands/suppressions"},{"title":"ahasend smtp: SMTP Credentials and Test Sends","icon":"server","sidebarTitle":"smtp","href":"/cli/commands/smtp"},{"title":"ahasend apikeys: Manage API Keys","icon":"key","sidebarTitle":"apikeys","href":"/cli/commands/apikeys"},{"title":"ahasend stats: Delivery and Bounce Reports","icon":"chart-line","sidebarTitle":"stats","href":"/cli/commands/stats"},{"title":"ahasend auth: Log In and Manage Profiles","icon":"user-shield","sidebarTitle":"auth","href":"/cli/commands/auth"},{"title":"ahasend ping: Test API Connectivity","icon":"wifi","sidebarTitle":"ping","href":"/cli/commands/ping"},{"title":"ahasend contacts: Manage Account Contacts","sidebarTitle":"contacts","icon":"address-book","href":"/cli/commands/contacts"},{"title":"ahasend lists: Manage Contact Lists","sidebarTitle":"lists","icon":"list-ul","href":"/cli/commands/lists"},{"title":"ahasend segments: Manage Contact Segments","sidebarTitle":"segments","icon":"filter","href":"/cli/commands/segments"},{"title":"ahasend templates: Transactional Templates","sidebarTitle":"templates","icon":"file-lines","href":"/cli/commands/templates"},{"title":"ahasend campaigns: Manage Campaigns","sidebarTitle":"campaigns","icon":"bullhorn","href":"/cli/commands/campaigns"},{"title":"ahasend subaccounts: Manage Sub-Accounts","sidebarTitle":"subaccounts","icon":"building","href":"/cli/commands/subaccounts"}]},{"group":"Features","pages":[{"title":"Send Batch Emails from CSV with the CLI","icon":"layer-group","sidebarTitle":"Batch Processing","href":"/cli/batch-processing"},{"title":"Message Content and Substitutions in the CLI","icon":"file-code","sidebarTitle":"Message Content","href":"/cli/templates"},{"title":"Test Webhooks Locally with the CLI","icon":"bug","sidebarTitle":"Webhook Testing","href":"/cli/webhook-testing"},{"title":"Test Inbound Email Routes Locally with the CLI","icon":"envelopes-bulk","sidebarTitle":"Route Testing","href":"/cli/route-testing"}]}]},{"tab":"Guides","icon":"plug","pages":[{"title":"Guides","href":"/guides"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Roadmap","icon":"map","pages":[{"title":"Roadmap","href":"/roadmap"}]}]},"basePath":"","title":"ahasend webhooks: Manage and Test Webhooks - AhaSend","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":[],"chunks":[]}