Email consent
Tell the panel who agreed to receive email from your business and who asked to stop. Email consent belongs to the email address and is separate from WhatsApp consent: these calls never change a contact's WhatsApp choice.
Base address: https://app.ezreach.in/api/v1
Record email consent
email:consentRecords up to 1,000 email addresses as subscribed or unsubscribed in one request. Every row gets its own result (changed, unchanged or refused with the reason), so one bad row never fails the batch. Somebody who unsubscribed is only subscribed again when occurredAt is later than the day they left.
Body
contactsrequiredobject[]
1–1,000 rows of { email, status: "subscribed" | "unsubscribed", evidence?, occurredAt? }. evidence (5–300 characters: how the person agreed) is required for subscribed. occurredAt is an ISO date.
Request
curl -X POST "https://app.ezreach.in/api/v1/email/consent" \
-H "Authorization: Bearer $EZREACH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contacts": [
{
"email": "ananya@example.com",
"status": "subscribed",
"evidence": "Ticked the offers box on our website sign-up form",
"occurredAt": "2026-10-01T09:30:00Z"
},
{
"email": "jordan@example.com",
"status": "unsubscribed"
}
]
}'Response
{
"data": {
"results": [
{
"index": 0,
"email": "ananya@example.com",
"result": "changed",
"status": "subscribed"
},
{
"index": 1,
"email": "jordan@example.com",
"result": "changed",
"status": "unsubscribed"
}
],
"summary": {
"changed": 2,
"unchanged": 0,
"refused": 0
}
}
}Errors
- 422
VALIDATION_ERRORcontacts is missing, empty or has more than 1,000 rows.
- 503
RESTART_NEEDEDEmail was installed while the panel was running: restart it once.
- A refused row has result "refused" and a reason: NO_EVIDENCE, INVALID_ADDRESS, UNSUBSCRIBED_AFTER (they left after occurredAt), SUPPRESSED_COMPLAINT, SUPPRESSED_BOUNCE, SUPPRESSED_PLATFORM, SUPPRESSED_MANUAL or ERASED.
- Somebody who marked your email as spam, whose address bounced for good, or who asked for erasure can never be subscribed again.
- Unsubscribing always works. It also puts the address on your suppression list.

