---
title: "Account permissions changed event"
method: POST
path: "account.permissions_changed"
tags: ["Webhook Events"]
---

# Account permissions changed event

`POST account.permissions_changed` (webhook)

Fired when a publish on an account connected through your own OAuth app fails for a missing permission. The account stays connected; only the missing area stops working until the permission is granted and the account reconnected.

## Payload

- WebhookPayloadAccountPermissionsChanged: Webhook payload for account.permissions_changed events: an account connected through your own OAuth app hit a missing permission and stays connected for its other areas.
  - `id` string, required: Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery.
  - `profiles` object[]: The profiles this event belongs to, each with the externalId you set on it (null when none is set). Use it to route the event to your tenant without storing Zernio profile ids. Present on every event tied to a profile, absent on events that belong to none. Events spanning several profiles (a post published to accounts of different profiles) list each once.
    - `id` string, required
    - `externalId` string, nullable, required
  - `test` boolean: Always true when present: only a sample sent by POST /v1/webhooks/test with an event carries it.
  - `event` 'account.permissions_changed', required
  - `account` object, required
    - `accountId` string, required
    - `profileId` string, required
    - `platform` string, required
    - `username` string, required
    - `displayName` string
    - `oauthAppId` string, required: The OAuth app the account connected through.
    - `missingScopeAreas` string[], required: Every area now missing. Enable the permission on your app (or have the user grant it), then reconnect the account.
    - `reason` string, required: The platform error that revealed it.
  - `timestamp` string, date-time, required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/c319eb5d95b6?raw)