Linked WhatsApp

Unofficial, opt-in: agents link their own WhatsApp by QR for 1:1 chats and replies they type — risk acceptances, company switch, devices.

GET/v1/whatsapp/linked

Linked WhatsApp: switches, risk notices and devices

PropZolo’s and the company’s switches, what stops the caller from linking, the risk notices to accept, the caller’s own device and — for admins (settings.communication) — every device. Needs inbox.link_whatsapp or settings.communication.

Access: Signed-in members only (web or Android session) — not for API keys.

Response · 200

datarequired: LinkedWhatsappOverview
metarequired: object

Request

curl -X GET 'https://api.propzolo.com/v1/whatsapp/linked' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "platform": {
      "configured": true,
      "mode": "string"
    },
    "plan": true,
    "policy": {
      "enabled": true,
      "unknown_numbers": "ignore",
      "history_sync_days": 0,
      "reply_first_days": 0,
      "changed_at": "string",
      "accepted": {
        "version": "string",
        "accepted_at": "2026-10-06T05:30:00.000Z",
        "by": "string",
        "current": true
      }
    },
    "can_link": true,
    "can_manage": true,
    "blockers": [
      {
        "code": "string",
        "message": "string"
      }
    ],
    "texts": {
      "company": {
        "scope": "company",
        "version": "string",
        "hash": "string",
        "title": "string",
        "paragraphs": [
          "string"
        ],
        "confirm": "string"
      },
      "member": {
        "scope": "company",
        "version": "string",
        "hash": "string",
        "title": "string",
        "paragraphs": [
          "string"
        ],
        "confirm": "string"
      }
    },
    "me": {
      "acceptance": {
        "version": "string",
        "accepted_at": "2026-10-06T05:30:00.000Z",
        "current": true
      },
      "link": {
        "id": "cmusrceel0000q7kaafxqi1om",
        "member_id": "cmusrceel0000q7kaafxqi1om",
        "member_name": "string",
        "status": "linking",
        "status_reason": "string",
        "status_at": "2026-10-06T05:30:00.000Z",
        "phone": "string",
        "push_name": "string",
        "platform": "string",
        "frozen": true,
        "banned_until": "2026-10-06T05:30:00.000Z",
        "usage": {
          "day": "string",
          "messages": 0,
          "message_cap": 0,
          "new_chats": 0,
          "new_chat_cap": 0,
          "queued": 0,
          "queue_capacity": 0,
          "at": "string"
        },
        "linked_at": "2026-10-06T05:30:00.000Z",
        "connected_at": "2026-10-06T05:30:00.000Z",
        "last_seen_at": "2026-10-06T05:30:00.000Z",
        "logged_out_at": "2026-10-06T05:30:00.000Z",
        "created_at": "2026-10-06T05:30:00.000Z",
        "prompt": {
          "tone": "info",
          "title": "string",
          "body": "string",
          "action": "relink"
        }
      },
      "history": [
        {
          "id": "cmusrceel0000q7kaafxqi1om",
          "member_id": "cmusrceel0000q7kaafxqi1om",
          "member_name": "string",
          "status": "linking",
          "status_reason": "string",
          "status_at": "2026-10-06T05:30:00.000Z",
          "phone": "string",
          "push_name": "string",
          "platform": "string",
          "frozen": true,
          "banned_until": "2026-10-06T05:30:00.000Z",
          "usage": {
            "day": "string",
            "messages": 0,
            "message_cap": 0,
            "new_chats": 0,
            "new_chat_cap": 0,
            "queued": 0,
            "queue_capacity": 0,
            "at": "string"
          },
          "linked_at": "2026-10-06T05:30:00.000Z",
          "connected_at": "2026-10-06T05:30:00.000Z",
          "last_seen_at": "2026-10-06T05:30:00.000Z",
          "logged_out_at": "2026-10-06T05:30:00.000Z",
          "created_at": "2026-10-06T05:30:00.000Z",
          "prompt": {
            "tone": "info",
            "title": "string",
            "body": "string",
            "action": "relink"
          }
        }
      ]
    },
    "devices": [
      {
        "id": "cmusrceel0000q7kaafxqi1om",
        "member_id": "cmusrceel0000q7kaafxqi1om",
        "member_name": "string",
        "status": "linking",
        "status_reason": "string",
        "status_at": "2026-10-06T05:30:00.000Z",
        "phone": "string",
        "push_name": "string",
        "platform": "string",
        "frozen": true,
        "banned_until": "2026-10-06T05:30:00.000Z",
        "usage": {
          "day": "string",
          "messages": 0,
          "message_cap": 0,
          "new_chats": 0,
          "new_chat_cap": 0,
          "queued": 0,
          "queue_capacity": 0,
          "at": "string"
        },
        "linked_at": "2026-10-06T05:30:00.000Z",
        "connected_at": "2026-10-06T05:30:00.000Z",
        "last_seen_at": "2026-10-06T05:30:00.000Z",
        "logged_out_at": "2026-10-06T05:30:00.000Z",
        "created_at": "2026-10-06T05:30:00.000Z",
        "prompt": {
          "tone": "info",
          "title": "string",
          "body": "string",
          "action": "relink"
        }
      }
    ]
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/whatsapp/linked/accept

Accept the linked WhatsApp risk notice

Records the member’s own acceptance (text version, its SHA-256, time, IP) once the company has switched linked WhatsApp on. 409 when the notice changed since it was shown.

Access: Signed-in members only (web or Android session) — not for API keys. Permission inbox.link_whatsapp.

Request body

versionrequired: string
hashrequired: string

Response · 201

datarequired: object
data.idrequired: Id
Opaque record id.
data.accepted_atrequired: DateTime
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/whatsapp/linked/accept' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"version":"string","hash":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "accepted_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/whatsapp/linked/links

Start linking my WhatsApp

Creates a link attempt on the bridge (or hands back the one still waiting for its QR scan). `phone` is the number that will be linked — another number scanning the code is refused; default: the member’s verified phone.

Access: Signed-in members only (web or Android session) — not for API keys. Permission inbox.link_whatsapp.

Request body

phone: string or null

Response · 201

datarequired: LinkedWhatsappDevice
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/whatsapp/linked/links' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"phone":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "member_id": "cmusrceel0000q7kaafxqi1om",
    "member_name": "string",
    "status": "linking",
    "status_reason": "string",
    "status_at": "2026-10-06T05:30:00.000Z",
    "phone": "string",
    "push_name": "string",
    "platform": "string",
    "frozen": true,
    "banned_until": "2026-10-06T05:30:00.000Z",
    "usage": {
      "day": "string",
      "messages": 0,
      "message_cap": 0,
      "new_chats": 0,
      "new_chat_cap": 0,
      "queued": 0,
      "queue_capacity": 0,
      "at": "string"
    },
    "linked_at": "2026-10-06T05:30:00.000Z",
    "connected_at": "2026-10-06T05:30:00.000Z",
    "last_seen_at": "2026-10-06T05:30:00.000Z",
    "logged_out_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "prompt": {
      "tone": "info",
      "title": "string",
      "body": "string",
      "action": "relink"
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

DELETE/v1/whatsapp/linked/links/{id}

Unlink a device

Your own device, or anyone’s for admins (settings.communication). The bridge unlinks it on the phone when it is online and wipes its keys either way; chats already copied stay in the inbox.

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: object
data.linkrequired: LinkedWhatsappDevice or null
data.unlinked_on_phonerequired: boolean or null
metarequired: object

Request

curl -X DELETE 'https://api.propzolo.com/v1/whatsapp/linked/links/{id}' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "link": {
      "id": "cmusrceel0000q7kaafxqi1om",
      "member_id": "cmusrceel0000q7kaafxqi1om",
      "member_name": "string",
      "status": "linking",
      "status_reason": "string",
      "status_at": "2026-10-06T05:30:00.000Z",
      "phone": "string",
      "push_name": "string",
      "platform": "string",
      "frozen": true,
      "banned_until": "2026-10-06T05:30:00.000Z",
      "usage": {
        "day": "string",
        "messages": 0,
        "message_cap": 0,
        "new_chats": 0,
        "new_chat_cap": 0,
        "queued": 0,
        "queue_capacity": 0,
        "at": "string"
      },
      "linked_at": "2026-10-06T05:30:00.000Z",
      "connected_at": "2026-10-06T05:30:00.000Z",
      "last_seen_at": "2026-10-06T05:30:00.000Z",
      "logged_out_at": "2026-10-06T05:30:00.000Z",
      "created_at": "2026-10-06T05:30:00.000Z",
      "prompt": {
        "tone": "info",
        "title": "string",
        "body": "string",
        "action": "relink"
      }
    },
    "unlinked_on_phone": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/whatsapp/linked/links/{id}/pair-code

Link with a code instead of the QR

WhatsApp → Linked devices → Link with phone number, then type the code shown.

Access: Signed-in members only (web or Android session) — not for API keys. Permission inbox.link_whatsapp.

Parameters

idpathrequired: Id
Opaque record id.

Request body

phonerequired: string

Response · 200

datarequired: object
data.coderequired: string
data.phonerequired: string
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/whatsapp/linked/links/{id}/pair-code' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"phone":"string"}'

Response example

{
  "data": {
    "code": "string",
    "phone": "string"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

GET/v1/whatsapp/linked/links/{id}/qr

QR codes of a link attempt (stream)

text/event-stream: `status`, `qr` ({ image: an SVG data URL, expires_at }, replaced about every 20 s), `paired`, `error` and `end`. Codes run out after about 160 s — start again then.

Access: Signed-in members only (web or Android session) — not for API keys. Permission inbox.link_whatsapp.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

No body.

Request

curl -X GET 'https://api.propzolo.com/v1/whatsapp/linked/links/{id}/qr' \
  -H 'Authorization: Bearer pz_live_…'

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/whatsapp/linked/links/{id}/refresh

Re-read a device from the bridge

Access: Signed-in members only (web or Android session) — not for API keys.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: LinkedWhatsappDevice
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/whatsapp/linked/links/{id}/refresh' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "member_id": "cmusrceel0000q7kaafxqi1om",
    "member_name": "string",
    "status": "linking",
    "status_reason": "string",
    "status_at": "2026-10-06T05:30:00.000Z",
    "phone": "string",
    "push_name": "string",
    "platform": "string",
    "frozen": true,
    "banned_until": "2026-10-06T05:30:00.000Z",
    "usage": {
      "day": "string",
      "messages": 0,
      "message_cap": 0,
      "new_chats": 0,
      "new_chat_cap": 0,
      "queued": 0,
      "queue_capacity": 0,
      "at": "string"
    },
    "linked_at": "2026-10-06T05:30:00.000Z",
    "connected_at": "2026-10-06T05:30:00.000Z",
    "last_seen_at": "2026-10-06T05:30:00.000Z",
    "logged_out_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "prompt": {
      "tone": "info",
      "title": "string",
      "body": "string",
      "action": "relink"
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/whatsapp/linked/links/{id}/resume

Resume sending on a frozen device

After a temporary ban ended or an auto-throttle was reviewed. 409 while WhatsApp’s ban still runs.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.communication.

Parameters

idpathrequired: Id
Opaque record id.

Response · 200

datarequired: LinkedWhatsappDevice
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/whatsapp/linked/links/{id}/resume' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "member_id": "cmusrceel0000q7kaafxqi1om",
    "member_name": "string",
    "status": "linking",
    "status_reason": "string",
    "status_at": "2026-10-06T05:30:00.000Z",
    "phone": "string",
    "push_name": "string",
    "platform": "string",
    "frozen": true,
    "banned_until": "2026-10-06T05:30:00.000Z",
    "usage": {
      "day": "string",
      "messages": 0,
      "message_cap": 0,
      "new_chats": 0,
      "new_chat_cap": 0,
      "queued": 0,
      "queue_capacity": 0,
      "at": "string"
    },
    "linked_at": "2026-10-06T05:30:00.000Z",
    "connected_at": "2026-10-06T05:30:00.000Z",
    "last_seen_at": "2026-10-06T05:30:00.000Z",
    "logged_out_at": "2026-10-06T05:30:00.000Z",
    "created_at": "2026-10-06T05:30:00.000Z",
    "prompt": {
      "tone": "info",
      "title": "string",
      "body": "string",
      "action": "relink"
    }
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
404 Not found — records of another company are reported the same way.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

POST/v1/whatsapp/linked/opt-out

Withdraw from linked WhatsApp

Withdraws the member’s acceptance and unlinks their phone (retried in the background if the bridge is down).

Access: Signed-in members only (web or Android session) — not for API keys. Permission inbox.link_whatsapp.

Response · 200

datarequired: object
data.unlinkedrequired: boolean
data.queuedrequired: boolean
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/whatsapp/linked/opt-out' \
  -H 'Authorization: Bearer pz_live_…'

Response example

{
  "data": {
    "unlinked": true,
    "queued": true
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

PATCH/v1/whatsapp/linked/policy

Switch linked WhatsApp on or off for the company

Switching on needs the company risk notice accepted (`acceptance`) and the plan feature. Switching off stops every linked send at once; with `unlink_all` every device is unlinked too. Also: what a first message from an unknown number does, and how many days of history a new link copies.

Access: Signed-in members only (web or Android session) — not for API keys. Permission settings.communication.

Request body

enabled: boolean
unknown_numbers: "ignore" | "enquiry"
history_sync_days: integer
reply_first_days: integer
Linked sends need the contact’s own message to that number within this many days.
acceptance: object
acceptance.versionrequired: string
acceptance.hashrequired: string
unlink_all: boolean

Response · 200

datarequired: object
data.enabledrequired: boolean
data.unknown_numbersrequired: "ignore" | "enquiry"
data.history_sync_daysrequired: integer
data.reply_first_daysrequired: integer
data.unlinkedrequired: integer
data.unlink_queuedrequired: integer
metarequired: object

Request

curl -X PATCH 'https://api.propzolo.com/v1/whatsapp/linked/policy' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"enabled":true,"unknown_numbers":"ignore","history_sync_days":0,"reply_first_days":1,"acceptance":{"version":"string","hash":"string"},"unlink_all":true}'

Response example

{
  "data": {
    "enabled": true,
    "unknown_numbers": "ignore",
    "history_sync_days": 0,
    "reply_first_days": 0,
    "unlinked": 0,
    "unlink_queued": 0
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

{ "data": { "platform": { "configured": true, "mode": "string" }, "plan": true, "policy": { "enabled": true, "unknown_numbers": "ignore", "history_sync_days": 0, "reply_first_days": 0, "changed_at": "string", "accepted": { "version": "string", "accepted_at": "2026-10-06T05:30:00.000Z", "by": "string", "current": true } }, "can_link": true, "can_manage": true, "blockers": [ { "code": "string", "message": "string" } ], "texts": { "company": { "scope": "company", "version": "string", "hash": "string", "title": "string", "paragraphs": [ "string" ], "confirm": "string" }, "member": { "scope": "company", "version": "string", "hash": "string", "title": "string", "paragraphs": [ "string" ], "confirm": "string" } }, "me": { "acceptance": { "version": "string", "accepted_at": "2026-10-06T05:30:00.000Z", "current": true }, "link": { "id": "cmusrceel0000q7kaafxqi1om", "member_id": "cmusrceel0000q7kaafxqi1om", "member_name": "string", "status": "linking", "status_reason": "string", "status_at": "2026-10-06T05:30:00.000Z", "phone": "string", "push_name": "string", "platform": "string", "frozen": true, "banned_until": "2026-10-06T05:30:00.000Z", "usage": { "day": "string", "messages": 0, "message_cap": 0, "new_chats": 0, "new_chat_cap": 0, "queued": 0, "queue_capacity": 0, "at": "string" }, "linked_at": "2026-10-06T05:30:00.000Z", "connected_at": "2026-10-06T05:30:00.000Z", "last_seen_at": "2026-10-06T05:30:00.000Z", "logged_out_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "prompt": { "tone": "info", "title": "string", "body": "string", "action": "relink" } }, "history": [ { "id": "cmusrceel0000q7kaafxqi1om", "member_id": "cmusrceel0000q7kaafxqi1om", "member_name": "string", "status": "linking", "status_reason": "string", "status_at": "2026-10-06T05:30:00.000Z", "phone": "string", "push_name": "string", "platform": "string", "frozen": true, "banned_until": "2026-10-06T05:30:00.000Z", "usage": { "day": "string", "messages": 0, "message_cap": 0, "new_chats": 0, "new_chat_cap": 0, "queued": 0, "queue_capacity": 0, "at": "string" }, "linked_at": "2026-10-06T05:30:00.000Z", "connected_at": "2026-10-06T05:30:00.000Z", "last_seen_at": "2026-10-06T05:30:00.000Z", "logged_out_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "prompt": { "tone": "info", "title": "string", "body": "string", "action": "relink" } } ] }, "devices": [ { "id": "cmusrceel0000q7kaafxqi1om", "member_id": "cmusrceel0000q7kaafxqi1om", "member_name": "string", "status": "linking", "status_reason": "string", "status_at": "2026-10-06T05:30:00.000Z", "phone": "string", "push_name": "string", "platform": "string", "frozen": true, "banned_until": "2026-10-06T05:30:00.000Z", "usage": { "day": "string", "messages": 0, "message_cap": 0, "new_chats": 0, "new_chat_cap": 0, "queued": 0, "queue_capacity": 0, "at": "string" }, "linked_at": "2026-10-06T05:30:00.000Z", "connected_at": "2026-10-06T05:30:00.000Z", "last_seen_at": "2026-10-06T05:30:00.000Z", "logged_out_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "prompt": { "tone": "info", "title": "string", "body": "string", "action": "relink" } } ] }, "meta": {} }

POST/v1/whatsapp/linked/accept

Accept the linked WhatsApp risk notice

Records the member’s own acceptance (text version, its SHA-256, time, IP) once the company has switched linked WhatsApp on. 409 when the notice changed since it was shown.

Access: Signed-in members only (web or Android session) — not for API keys. Permission inbox.link_whatsapp.

Request body

versionrequired: string
hashrequired: string

Response · 201

datarequired: object
data.idrequired: Id
Opaque record id.
data.accepted_atrequired: DateTime
Instant in ISO 8601, e.g. 2026-10-03T04:30:00.000Z.
metarequired: object

Request

curl -X POST 'https://api.propzolo.com/v1/whatsapp/linked/accept' \
  -H 'Authorization: Bearer pz_live_…' \
  -H 'Content-Type: application/json' \
  -d '{"version":"string","hash":"string"}'

Response example

{
  "data": {
    "id": "cmusrceel0000q7kaafxqi1om",
    "accepted_at": "2026-10-06T05:30:00.000Z"
  },
  "meta": {}
}

Errors

401 No valid session or API key (missing, expired or revoked).
403 The caller lacks the permission, API-key scope or support grant this operation needs.
409 A unique value already exists, a concurrent change won, or the Idempotency-Key is still in use or was sent with a different request.
422 Invalid input; `error.fields` maps field paths to messages.
429 Too many requests; retry after the Retry-After header.
500 Unexpected error; quote `error.request_id` to support.

{ "data": { "id": "cmusrceel0000q7kaafxqi1om", "member_id": "cmusrceel0000q7kaafxqi1om", "member_name": "string", "status": "linking", "status_reason": "string", "status_at": "2026-10-06T05:30:00.000Z", "phone": "string", "push_name": "string", "platform": "string", "frozen": true, "banned_until": "2026-10-06T05:30:00.000Z", "usage": { "day": "string", "messages": 0, "message_cap": 0, "new_chats": 0, "new_chat_cap": 0, "queued": 0, "queue_capacity": 0, "at": "string" }, "linked_at": "2026-10-06T05:30:00.000Z", "connected_at": "2026-10-06T05:30:00.000Z", "last_seen_at": "2026-10-06T05:30:00.000Z", "logged_out_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "prompt": { "tone": "info", "title": "string", "body": "string", "action": "relink" } }, "meta": {} }

{ "data": { "link": { "id": "cmusrceel0000q7kaafxqi1om", "member_id": "cmusrceel0000q7kaafxqi1om", "member_name": "string", "status": "linking", "status_reason": "string", "status_at": "2026-10-06T05:30:00.000Z", "phone": "string", "push_name": "string", "platform": "string", "frozen": true, "banned_until": "2026-10-06T05:30:00.000Z", "usage": { "day": "string", "messages": 0, "message_cap": 0, "new_chats": 0, "new_chat_cap": 0, "queued": 0, "queue_capacity": 0, "at": "string" }, "linked_at": "2026-10-06T05:30:00.000Z", "connected_at": "2026-10-06T05:30:00.000Z", "last_seen_at": "2026-10-06T05:30:00.000Z", "logged_out_at": "2026-10-06T05:30:00.000Z", "created_at": "2026-10-06T05:30:00.000Z", "prompt": { "tone": "info", "title": "string", "body": "string", "action": "relink" } }, "unlinked_on_phone": true }, "meta": {} }

curl -X PATCH 'https://api.propzolo.com/v1/whatsapp/linked/policy' \ -H 'Authorization: Bearer pz_live_…' \ -H 'Content-Type: application/json' \ -d '{"enabled":true,"unknown_numbers":"ignore","history_sync_days":0,"reply_first_days":1,"acceptance":{"version":"string","hash":"string"},"unlink_all":true}'