---
title: "Transaction updated fields"
method: POST
path: "transactionEvents_webhook-transaction-updated-fields"
---

# Transaction updated fields

`POST transactionEvents_webhook-transaction-updated-fields` (webhook)

Webhook for the `transaction.updated-fields` event. Fires when one or more of a Transaction's fields are updated. For more info see [Webhooks Overview](https://docs.withpersona.com/webhooks).

## Headers

- `Persona-Signature` string
- `Persona-Webhook-Attempts-Made` integer
- `Persona-Webhook-Attempts-Left` integer
- `Persona-Webhook-First-Attempted-At` integer

## Payload

- object
  - `data` WebhooksWebhookTransactionUpdatedFieldsPayloadContentApplicationJsonSchemaData
    - `type` 'event'
    - `id` string: Unique identifier for this Event. Starts with `evt_`.
    - `attributes` WebhooksWebhookTransactionUpdatedFieldsPayloadContentApplicationJsonSchemaDataAttributes
      - `created-at` string, date-time: Datetime when the event was created.
      - `name` 'transaction.updated-fields'
      - `payload` WebhooksWebhookTransactionUpdatedFieldsPayloadContentApplicationJsonSchemaDataAttributesPayload
        - `data` Transaction
          - `id` string: Unique identifier for this Transaction. Starts with `txn_`.
          - `attributes` VerificationIncludedObjectsItemsDiscriminatorMappingTransactionAttributes
            - `status` string
            - `reference-id` string, nullable
            - `fields` object: JSON key-value pairs of field name to field value. Exact schema depends on the configuration of the Transaction Type for this Transaction.
            - `tags` string[]
            - `signals` object: Risk signals computed for this Transaction, keyed by signal name. Only present for Transactions whose Transaction Type has Sentinel enabled; signals appear once the Sentinel session has been processed. Specific keys are not enumerated in the public spec and may be added or removed over time. Contact your Persona account team for more information.
            - `created-at` string, date-time
            - `updated-at` string, date-time, nullable
          - `relationships` VerificationIncludedObjectsItemsDiscriminatorMappingTransactionRelationships
            - `reviewer` VerificationIncludedObjectsItemsDiscriminatorMappingTransactionRelationshipsReviewer: The entity that reviewed the transaction
              - …
            - `transaction-label` VerificationIncludedObjectsItemsDiscriminatorMappingTransactionRelationshipsTransactionLabel
              - …
            - `transaction-type` VerificationIncludedObjectsItemsDiscriminatorMappingTransactionRelationshipsTransactionType
              - …
            - `related-objects` VerificationIncludedObjectsItemsDiscriminatorMappingTransactionRelationshipsRelatedObjects: Objects involved in this Transaction's related Workflow runs.
              - …
            - `sentinel-sessions` VerificationIncludedObjectsItemsDiscriminatorMappingTransactionRelationshipsSentinelSessions: The Sentinel sessions that collected device and network data for this Transaction. Present on every Transaction; `data` is empty unless the Transaction has one or more Sentinel sessions.
              - …
        - `included` TransactionsIncludedObjectsItems[]: Full representations of the objects referenced in `data.attributes.relationships` — the Transaction's Transaction Type, its reviewer (a Workflow Run, Workflow Step, or User), its Sentinel Session, and any related objects such as Accounts, Inquiries, Verifications, Reports, or Cases. The set of types that appear depends on what the Transaction is related to.
          - `type` string, required: The type of the included object.
          - `id` string, required: Unique identifier for the included object.

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/withpersona/apis/withpersona-2.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-2/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-2/revisions/f1c78133b3b2?raw)