---
title: "channel.needs_reconnect"
method: POST
path: "channel.needs_reconnect"
---

# channel.needs_reconnect

`POST channel.needs_reconnect` (webhook)

A channel lost access (revoked or expired) and needs reconnecting in Postbase.

## Headers

- `Postbase-Event-Id` string
- `Postbase-Event-Type` string
- `Postbase-Timestamp` string
- `Postbase-Signature` string

## Payload

- object
  - `id` string, uuid, required: Unique per event: use it to ignore repeats
  - `type` string, required
  - `created_at` string, date-time, required
  - `workspace_id` string, uuid
  - `data` object, required
    - `channel` object
      - `id` string
      - `platform` string
      - `handle` string, nullable
      - `status` string
      - `error` string

## Acknowledgement `200`

Return any 2xx within 10 seconds. Anything else is retried with backoff (1 min, 5 min, 30 min, 2 h, 6 h).

---

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