Email notifications for build plan with specs-yaml
Asked by matgry:

I've gotten email notifications to work in a yaml-spec deployment and according to the spec-yaml reference [here](https://docs.atlassian.com/bamboo-specs-docs/6.9.0/specs.html?yaml#notifications)

it seems possible to also do it from a yaml-specced build plan. However, there are no examples of that in the reference so the exact way of doing that eludes me. I have tried the same syntax bit (with "plan-finished" event):

```
notifications:
    - events:
        - deployment-finished
    recipients:
        - emails:
        - m@j.com
```

in different places in the plan yaml document, but cannot find the right place for it. Validation error message is:

```
Document structure is incorrect: Found following unused properties: notifications
```

Anyone tried and succeeded with this?

While I'm on the subject: is there a list of yaml-names for the different plan events that can trigger notifications? I guess I could trial and error it from converting non-yaml plans to java specs and hope that the java classes are actually named like the events, but... :)


Answers:
author: Daniel Santos
body: Hi [@matgry](/t5/user/viewprofilepage/user-id/3372277)

The absence of examples happens because there is no implementation for plan notifications at the moment. I was able to talk to one of our developers and this feature was postponed due to possible design conflicts with other feature that is still in course of conclusion. That is the reason we have notifications for deployment but not for plans.

We have a feature request tracking the interest of users in this feature to help us prioritize its implementation. This is the one:

* [\[BAM-20485\] YAML Specs: define plan notifications for build success/failure](https://jira.atlassian.com/browse/BAM-20485)

I encourage you to vote on it to help us track your interest in this feature. Unfortunately, I don't have a workaround for this. What you could try is using a script task to send mails with the **mutt** command, but you will face issues to send them when the build fails.

I hope this information helps you to move forward somehow.

comments: author: matgry
body: Ah. Did not see the JIRA issue. Voted.

In the meantime, it would be nice to have the yaml documentation reflect the state of affairs. Presently, one could be forgiven for thinking that there is support for plan notifications in yaml:

[https://docs.atlassian.com/bamboo-specs-docs/6.9.0/specs.html?yaml#notifications said:](https://docs.atlassian.com/bamboo-specs-docs/6.9.0/specs.html?yaml#notifications)

"Notifications in Bamboo are triggered by a range of events involving a **plan and its jobs** , including build completion, build outcomes and comments being posted against build results. You can configure whether notifications are sent for a particular event for **each plan and job**, and who they are sent to".

Thanks,

Mattias


author: Daniel Santos
body: Hi [@matgry](/t5/user/viewprofilepage/user-id/3372277)

Thank you so much for the feedback. I'll open another ticket to request this update in our docs.


author: Daniel Santos
body: Hi [@matgry](/t5/user/viewprofilepage/user-id/3372277)  

This is the one:

* [\[BAM-20536\] Update YAML reference misleading information about notifications](https://jira.atlassian.com/browse/BAM-20536)

Let me know if you need anything else in this matter.  


Tags: yaml