# Communicator

Send and receive communications like email and text messages with borrowers and their contacts. When
sending and receiving communications an interaction is usually created.

 - [POST /communicator/preview](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.preview.md): Render the template and return as a JSON response. It selects an appropriate Template Descriptor (matching `subject`, `channel`), and renders the active Template Version with the given `context`. The
 - [POST /communicator/preview-free-form-email](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.preview_free_form_email.md): Render a template for "free-form" emails and return is as JSON. A free-form message is one that can contain any content. Templates previewed via this endpoint will be free-form but still be branded. i
 - [POST /communicator/receive](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.handle_receive.md): Receive a message. This is different from a normal `/interactions` creation because it creates the interaction and also performs associated "inbound message" actions: - if the message is an email sent
 - [POST /communicator/render](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.render.md): Render a file (`text`, `html` or `pdf`) from template and download it. It selects an appropriate Template Descriptor (matching `subject`, `channel`), and renders the active Template Version with the g
 - [POST /communicator/render-to-document](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.render_to_document.md): Render a file (`text`, `html` or `pdf`) from template and write it to a document descriptor. It selects an appropriate Template Descriptor (matching `subject`, `channel`), and renders the active Templ
 - [POST /communicator/resend](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.resend.md): Copy the fields from an existing interaction into a new interaction and queue that new interaction for sending. WARNING: This message is not checked against Compliance Guard.
 - [POST /communicator/send](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.handle_send.md): Send a message and save it as a new interaction. The message is checked against Compliance Guard and may be rejected if it violates any rules. If the message is accepted, it is queued for send. You ca
 - [POST /communicator/send-confirmation-code](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.confirmation_codes.handlers.send_confirmation_code.md): Send a verification code to an email or phone number. This creates a confirmation code in the system which can be used via the `.../contacts` endpoint to verify the contact. (i.e., this sets the `veri
 - [POST /communicator/send-free-form-email](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.send_free_form_email.md): Sends an email with the `freeFormBranded` template. This selects the Template Descriptor with `subject=freeFormBranded` and its currently active Template Version. The `freeFormBranded`` template allow
 - [GET /communicator/subjects](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.subject_descriptors_list.md): List all the currently available Interaction Subject descriptors. An interaction subject is the category or topic to which an interaction pertains. (Note this is different from the subject line of an
 - [GET /communicator/subjects/{subject}](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.subject_descriptor_get_by_subject.md): Get the descriptor for a specific Interaction Subject. Note that subject descriptors do not have an `id` field but are instead identified by their unique `subject` field.
 - [PUT /communicator/subjects/{subject}](https://docs.peachfinance.com/api-docs/api-public/communicator/peach.communicator.handlers.subject_descriptor_update.md): Update the descriptor for a specific Interaction Subject. Note that subject descriptors do not have an `id` field but are instead identified by their unique `subject` field.