FAQ Q284: Why didn't Planyo send an email notification?

1. Finding the cause

There can be different reasons for this and it's also possible that Planyo actually sent a notification but it never arrived in the recipient's inbox. Let's first identify the actual problem.

If the recipient of the notification that wasn't received is a customer, then you should go to the reservation details page and examine the section Notifications sent to the customer. All the notifications sent by planyo for given reservation ID are listed here together with the date and time when the email was sent, the success status and a link which resends the email to the customer. If you see the notification in this list, check the status and comments. If there was an error sending the email, you'll see the error message in the comments field (most likely, a misspelled email address). If, on the other hand, the status is success, then this means that the email notification was actually sent. Proceed to point 2 of this tutorial to fix this issue which obviously is related to the recipient's inbox software or their mail server marking the email as spam and preventing the customer from seeing it.

If the recipient of the notification is not a customer but one of the administrators and you double checked that the administrator's email address is correct (not misspelled!), then you should go to Site settings / Planyo site settings / Active features and switch on the option Email notifications debug log. From this moment on, all email notifications sent by planyo will be recorded in a special log (the link to view the log can be found next to this option in active features and also on the reservation details page). You can review the log the next time an email doesn't get sent and check for an error message. Once again, if you see the email notification was sent and the status is success, you know that the problem is with the spam (see point 2 below) and not with your configuration.

2. Fixing the spam issue (email sent by Planyo but never arrived in inbox)

By default, emails from planyo will probably never end up in spam because we use a @planyo.com address as the sender (and your email address in the reply-to field). We also use authentication methods such as DKIM/SPF to let the recipient's mail server know the email is authentic. If you changed your email settings and set your email address to be used in the from field, you may have this problem. Please see Q188 for a detailed analysis of the spam problem and the possible solutions.

3. Fixing the notification settings to ensure the desired notifications are sent

The most obvious cause for an email not being sent at all is that in Settings / Notification settings you didn't select a checkbox next to the notification which you want to be sent and next to the user role which should receive the notification. For example, if you want the main admin to receive an email whenever a customer cancels their reservation, make sure that the checkbox is selected in the site admin column and for the event Reservation cancelled by client.

Another possible problem is that a given user role (specifically resource admin or main moderator) doesn't exist or their email address is invalid. This can be easily checked in the settings of your planyo site (if main moderator) or the settings of your resource (if resource admin). If the email was supposed to be sent to the customer, double check that the spelling of their email address is correct.

The last potential problem is that the email notification is configured correctly and the recipient's email address is correct but the notification's body is empty. This can happen if you take advantage of the feature of planyo which suppresses sending of email messages with an empty body which is used if you want to send an email conditionally. In such case you wrap the entire body inside a conditional tag. In Settings / Notification settings you can select such email notification and test it against a specific reservation ID. If you notice the body is empty, you know this is the issue. Otherwise (if any text is present) the email gets sent.
Back to Frequently Asked Questions