---
title: "Account updated tags"
method: POST
path: "accountEvents_webhook-account-updated-tags"
---

# Account updated tags

`POST accountEvents_webhook-account-updated-tags` (webhook)

Webhook for the `account.updated-tags` event. The `context` identifies the tags added and removed by the update. 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` WebhooksWebhookAccountUpdatedTagsPayloadContentApplicationJsonSchemaData
    - `type` 'event'
    - `id` string: Unique identifier for this Event. Starts with `evt_`.
    - `attributes` WebhooksWebhookAccountUpdatedTagsPayloadContentApplicationJsonSchemaDataAttributes
      - `created-at` string, date-time: Datetime when the event was created.
      - `name` 'account.updated-tags'
      - `context` WebhooksWebhookAccountUpdatedTagsPayloadContentApplicationJsonSchemaDataAttributesContext: Identifies the tag names added to and removed from the Account.
        - `added-tags` string[]: Names of tags added by this update. Empty if none were added.
        - `removed-tags` string[]: Names of tags removed by this update. Empty if none were removed.
      - `payload` WebhooksWebhookAccountUpdatedTagsPayloadContentApplicationJsonSchemaDataAttributesPayload
        - `data` Account: An Account object. Note that `fields` is **not** key inflected.
          - `id` string
          - `attributes` VerificationIncludedObjectsItemsDiscriminatorMappingAccountAttributes
            - `reference-id` string, nullable
            - `account-type-name` string
            - `created-at` string, date-time
            - `updated-at` string, date-time
            - `redacted-at` string, date-time, nullable
            - `fields` VerificationIncludedObjectsItemsDiscriminatorMappingAccountAttributesFields: JSON key-value pairs of field name to field value. Exact schema depends on the configuration of the Account Type for this Account. Keys in `fields` are **not** key inflected.
              - …
            - `tags` string[]
            - `account-status` string
          - `relationships` VerificationIncludedObjectsItemsDiscriminatorMappingAccountRelationships
            - `account-type` VerificationIncludedObjectsItemsDiscriminatorMappingAccountRelationshipsAccountType
              - …
        - `included` AccountsIncludedObjectsItems[]
          - `type` 'account-type', required: Discriminator value: account-type
          - `id` string
          - `attributes` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeAttributes
            - `name` string
            - `created-at` string, date-time
            - `updated-at` string, date-time, nullable
            - `field-schemas` FieldSchema[]
              - …
          - `relationships` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationships
            - `account-statuses` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationshipsAccountStatuses
              - …
            - `default-account-status` AccountsIncludedObjectsItemsDiscriminatorMappingAccountTypeRelationshipsDefaultAccountStatus
              - …

## Acknowledgement `200`

Webhook received successfully

---

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