Manage communications
Reference Specification
Functional walkthroughs and developer integration endpoints.
User Guide
The Communications hub lets authorised organisation staff email people already connected
to the organisation, including imported contacts.
- Choose Email people to send to everyone or people with a tag. Use People to hand-pick recipients.
- Choose Direct or Campaign, check eligibility, and compose from blank or a reusable template.
- Review the email and queue it immediately. The delivery page shows recipient outcomes.
- Where a configured mailbox is available, direct emails can track replies in that mailbox.
Each recipient has a separate conversation, accessible to authorised mailbox colleagues.
- Use Inbox to handle conversations alongside your other work. Filter to a mailbox to start
a conversation with a new email address where that option is available.
Mailbox reply tracking currently runs in local development. Campaign delivery retains its
existing workflow. The current email wizard queues immediately; it does not schedule a future send.
Developer Spec
- Hub:
/organisations/:id/manage/communications - New email:
/organisations/:id/manage/communications/new - Delivery detail:
/organisations/:id/manage/communications/:communicationId - Templates:
/organisations/:id/manage/communications/templates - Queue API:
POST /organisations/:id/manage-users/emails - Eligibility API:
POST /organisations/:id/manage-users/email-eligibility-preview - Delivery API:
GET /organisations/:id/manage-communications/:jobPublicId - Conversation Inbox:
/inbox?kind=communications
People sending requires organisations.members.manage. Tracked sending additionally requires
central mailbox view/send authorisation; People access alone does not grant mailbox access.