---
title: "A non-reserved keyword fired for a profile."
method: POST
path: "keyword.triggered"
tags: ["webhooks"]
---

# A non-reserved keyword fired for a profile.

`POST keyword.triggered` (webhook)

## Headers

- `Postscript-Webhook-Signature` string, required

## Payload

- KeywordTriggerWebhook: The body of every delivery. Delivery is at least once; deduplicate on `id`.
  - `account_id` string, required
  - `api_version` string, date, required
  - `data` object, required: The topic's payload.
    - `keyword` string, required
    - `keyword_id` string, required
    - `matched_text` string, required
    - `occurred_at` string, date-time, required
    - `profile_id` string, required
  - `event_type` string, required
  - `id` string, required: The same on every retry.
  - `livemode` boolean, required
  - `object` 'webhook_event', required
  - `occurred_at` string, date-time, required
  - `subject` string, nullable, required: The entity that this delivery is about.

## Acknowledgement `2XX`

Return any 2xx within 10 seconds to acknowledge the delivery. Network errors, timeouts, and 408, 409, 425, 429 and 5xx responses are retried for up to 72 hours; any other response fails the delivery without a retry.

---

[API](https://skmtc.dev/pscrpt/apis/postscript-native-api-beta.md) - [All operations](https://skmtc.dev/pscrpt/apis/postscript-native-api-beta/llms.txt) - [OpenAPI document](https://skmtc.dev/pscrpt/apis/postscript-native-api-beta/revisions/882458ee1f36?raw)