# WebhookProperties

Type: object

Schema: [WebhookProperties](https://sourcey-firefly.pages.dev/api/models/webhookproperties/index.md)

- `created_at` (optional)
  Type: string, date-time
  
  readOnly: true
  
  Example:
  
  ```json
  "2026-10-01T00:00:00+00:00"
  ```

- `updated_at` (optional)
  Type: string, date-time
  
  readOnly: true
  
  Example:
  
  ```json
  "2026-10-01T00:00:00+00:00"
  ```

- `active` (optional)
  Type: boolean
  
  Boolean to indicate if the webhook is active
  
  Example:
  
  ```json
  false
  ```

- `title` (required)
  Type: string, string
  
  A title for the webhook for easy recognition.
  
  Example:
  
  ```json
  "Update magic mirror on new transaction"
  ```

- `secret` (optional)
  Type: string, string
  
  A 24-character secret for the webhook. It's generated by Firefly III when saving a new webhook. If you submit a new secret through the PUT endpoint it will generate a new secret for the selected webhook, a new secret bearing no relation to whatever you just submitted.
  
  readOnly: true
  
  Example:
  
  ```json
  "iMLZLtLx2JHWhK9Dtyuoqyir"
  ```

- `triggers` (optional)
  Reference: [WebhookTriggerArray](https://sourcey-firefly.pages.dev/api/models/webhooktriggerarray/index.md); Type: array
  
  minItems: 1
  
  maxItems: 3
  
  Example:
  
  ```json
  [
    "STORE_TRANSACTION",
    "UPDATE_TRANSACTION"
  ]
  ```

- `responses` (optional)
  Reference: [WebhookResponseArray](https://sourcey-firefly.pages.dev/api/models/webhookresponsearray/index.md); Type: array
  
  minItems: 1
  
  maxItems: 1
  
  Example:
  
  ```json
  [
    "TRANSACTIONS"
  ]
  ```

- `deliveries` (optional)
  Reference: [WebhookDeliveryArray](https://sourcey-firefly.pages.dev/api/models/webhookdeliveryarray/index.md); Type: array
  
  minItems: 1
  
  maxItems: 1
  
  Example:
  
  ```json
  [
    "JSON"
  ]
  ```

- `url` (required)
  Type: string, string
  
  The URL of the webhook. Has to start with `https`.
  
  Example:
  
  ```json
  "https://example.com"
  ```