Error

recipient_not_allowed

The channel does not allow this recipient

HTTP status403
RetryNo: fix the request first
detailschannel.

What happened

The channel does not allow this recipient.

Why

The channel's rules do not allow starting a conversation with this recipient. Email: a new email (no thread with the person yet) goes only to a verified member of the workspace; anyone else has to write to the mailbox first.

How to fix it

Reply in an existing conversation instead, or wait for the person to write first.

Example response

HTTP 403
{
  "error": "recipient_not_allowed",
  "message": "The channel does not allow this recipient.",
  "requestId": "req-8f2c1d4b",
  "retryable": false,
  "docs": "https://docs.vlayers.ai/errors/recipient_not_allowed"
}

See Errors, retries and idempotency for how to handle errors in general.

On this page