Email Notification#

Contact Site Owner (Contact Form)#

Plone allows the user to contact the site owner via a form on the website. This makes sure the site owner does not have to expose their email addresses publicly. At the same time, it allows the users to reach out to the site owners.

To send an email notification to the site owner, send a POST request to the /@email-notification endpoint that is available on the site root:

POST http://localhost:8080/Plone/@email-notification
Accept: application/json
Content-Type: application/json

{
  "name": "John Doe",
  "from": "john@doe.com",
  "subject": "Hello!",
  "message": "Just want to say hi."
}

The from and message fields are required. The subject and name fields are optional.

The server will respond with status 204 No Content when the email has been sent successfully:

HTTP/1.1 204 No Content

Contact Portal Users#

Note

This endpoint is NOT implemented yet.

To send an email notification to another user of the portal, send a POST request to the /@email-notification endpoint on a particular user, for example, the admin user:

POST http://localhost:8080/Plone/@users/admin/@email-notification
Accept: application/json
Content-Type: application/json

{
  "name": "John Doe",
  "from": "john@doe.com",
  "subject": "Hello!",
  "message": "Just want to say hi."
}

Note

When using "email as login", we strongly recommend to also enable the "Use UUID user ids" setting in the security control panel to obfuscate the email in the user endpoint URL. Otherwise the @users endpoint will expose the email addresses of all your users.