Skip to main content
POST
Agency Email Preferences
Your clients live inside your sub-workspaces. This stops Tuco emailing them directly — campaign summaries, reply alerts, billing notices — across the whole group, or in one workspace, or for one email type.

Endpoint

  • Method: POST (read the current state with GET on the same path)
  • Path: /api/agency/email-preferences
  • Auth: Authorization: Bearer tucoagency_xxxxxxxxxxxxx (agency key)

Body

Silence everything, everywhere

Narrower changes

What it does and does not touch

  • Preferences are per member, per workspace. The call writes every member of every targeted workspace, including members who had no stored preference and were therefore on the default (everything on).
  • Settings are merged, not replaced. Turning reply off keeps your existing reply.mode; turning other types off leaves reply alone.
  • Your own agency account is not affected. Silencing your clients does not silence you.
  • line_health is accepted for completeness, but line-down and recovery emails are governed by each line’s own Line Down Notifications toggle, not by this preference. Turning line_health off here will not stop them.

Reading the current state

A workspace with membersWithPreferences: 0 has nobody on a stored preference, so everyone there is on the defaults — anyEmailsEnabled is true. Add ?workspaceId=org_… to read one workspace.

Error responses