---
title: "Subscribe or opt out an iMessage contact"
method: POST
path: "/v1/imessage/audience/subscription"
tags: ["iMessage"]
---

# Subscribe or opt out an iMessage contact

`POST /v1/imessage/audience/subscription`

Opted-out contacts are refused at send time (409 recipient_opted_out) until re-subscribed. Their inbound messages still arrive. Scoped to your account: it does not change the contact's state with other businesses.

## Request body

- object
  - `accountId` string, required
  - `conversationId` string, required
  - `subscribed` boolean, required

## Response `200`

Updated

- object
  - `success` boolean
  - `conversationId` string
  - `subscribed` boolean

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Account or conversation not found

## Changes

- **2026-09-21** `339f59df69dd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/imessage/audience/subscription/post.md)

---

[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/339f59df69dd?raw)