Skip to content
Rhino Relay docs

422 consent_required

HTTP status
422
Code
consent_required
Title
Consent required
Meaning
Subscribed contacts need a consent record.

What to do

A subscribed contact needs a consent record: where and when they agreed, and how. Add one, or create the contact as unsubscribed.

Where it comes from

  • POST /v1/contacts

The response

Errors are application/problem+json (RFC 9457). detail never repeats the values you sent, and type links to this page. Quote requestId if you contact support.

{
  "type": "https://docs.rhinorelay.com/api/errors/consent-required/",
  "title": "Consent required",
  "status": 422,
  "code": "consent_required",
  "detail": "Subscribed contacts need a consent record.",
  "requestId": "req_01J9Z8X7W6V5T4S3R2Q1P0N9M8"
}

See it

With $BASE and $KEY set as in the quick start:

Terminal window
# Expect 422 consent_required
curl -X POST "$BASE/contacts" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{"email":"new@example.com"}'

Every error code