Email notification
Learn more about:
POST Parameters
Name | Type | Description |
---|---|---|
name Required | String | The name of the action. |
type Required | String | The type of the action. Should be set to EMAIL . |
recipients Required | String | The recipients of the notification: email addresses (one per line). One of send_to_groups or recipients must be specified. |
send_to_groups Required | String | The list of groups' names to which emails will be sent. One of send_to_groups or recipients must be specified. |
content | String | The content of the notification. |
title | String | The title of the notification. |
send_as_html | Boolean | Defines whether to send the content as HTML. |
file_attachments | String[] | The attached files. |
from_name | String | The e-mail sender name. |
Example
Request
POST https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions
JSON
{
"name": "EMAIL Action",
"type": "EMAIL",
"trigger_time": "ON_EVERY_EXECUTION",
"variables": [
{
"key": "emailTitle",
"value": "Pipeline executed successfully!"
}
],
"file_attachments": [
"fs:///file1",
"fs:///file2"
]
"content": "<b>${BUDDY_PIPELINE_NAME}</b> execution #${BUDDY_EXECUTION_ID}"
"recipients": "admin@mailinator.com\nmanage@mailinator.com",
"title": "$emailTitle",
"from_name": "Buddy",
"send_as_html": true
"send_to_groups": [
"Managers",
"Developers"
],
}
Sample Response
HTTP
Status: 201 Created
X-Rate-Limit-Limit: 1
X-Rate-Limit-Remaining: 999
JSON
{
"url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2/actions/2",
"html_url": "https://app.buddy.works/buddy/company-website/pipelines/action/2/edit",
"id": 2,
"name": "EMAIL Action",
"type": "EMAIL",
"trigger_time": "ON_EVERY_EXECUTION",
"variables": [
{
"key": "emailTitle",
"value": "Pipeline executed successfully!"
}
],
"file_attachments": [
"fs:///file1",
"fs:///file2"
]
"last_execution_status": "INITIAL",
"title": "$emailTitle",
"from_name": "Buddy",
"content": "<b>${BUDDY_PIPELINE_NAME}</b> execution #${BUDDY_EXECUTION_ID}",
"recipients": "admin@mailinator.com\nmanage@mailinator.com",
"send_as_html": true,
"pipeline": {
"url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/2",
"html_url": "https://app.buddy.works/buddy/company-website/pipelines/pipeline/2",
"id": 2,
"name": "Live mirror",
"on": "CLICK",
"refs": [
"refs/heads/master",
],
"last_execution_status": "SUCCESSFUL",
"last_execution_revision": "506a3963507943d6908154f4bc9646e829128a08",
"send_to_groups": [
"Managers",
"Developers"
]
}
}
Last modified on November 16, 2022