import validate from "validate.js";
import common from "../common/common.mjs";
export default {
...common,
key: "sendgrid-send-email-single-recipient",
name: "Send Email Single Recipient",
description: "This action sends a personalized e-mail to the specified recipient. [See the docs here](https://docs.sendgrid.com/api-reference/mail-send/mail-send)",
version: "0.0.6",
type: "action",
props: {
...common.props,
fromEmail: {
propDefinition: [
common.props.sendgrid,
"fromEmail",
],
},
fromName: {
propDefinition: [
common.props.sendgrid,
"fromName",
],
},
toEmail: {
type: "string",
label: "To Email",
description: "The intended recipient's email address",
},
toName: {
type: "string",
label: "To Name",
description: "The intended recipient's name",
optional: true,
},
cc: {
type: "string",
label: "CC",
description:
"An array of recipients who will receive a copy of your email. Each object in this array must contain the recipient's email address. Each object in the array may optionally contain the recipient's name. Alternatively, provide a string that will `JSON.parse` to an array of recipient objects. Example: `[{\"email\":\"email@example.com\",\"name\":\"Example Recipient\"}]`",
optional: true,
},
bcc: {
type: "string",
label: "BCC",
description: "An array of recipients who will receive a blind copy of your email. Each object in this array must contain the recipient's email address. Each object in the array may optionally contain the recpient's name. Alternatively, provide a string that will `JSON.parse` to an array of recipient objects. Example: `[{\"email\":\"email@example.com\",\"name\":\"Example Recipient\"}]`",
optional: true,
},
personalizationHeaders: {
type: "object",
label: "Personalization.Headers",
description: "An object containing key/value pairs allowing you to specify handling instructions for your email. You may not overwrite the following headers: `x-sg-id`, `x-sg-eid`, `received`, `dkim-signature`, `Content-Type`, `Content-Transfer-Encoding`, `To`, `From`, `Subject`, `Reply-To`, `CC`, `BCC`.",
optional: true,
},
substitutions: {
type: "string",
label: "Substitutions",
description: "Substitutions allow you to insert data without using Dynamic Transactional Templates. This field should not be used in combination with a Dynamic Transactional Template, which can be identified by a `template_id` starting with `d-`. This field is a collection of key/value pairs following the pattern `\"substitution_tag\":\"value to substitute\"`. The key/value pairs must be strings. These substitutions will apply to the text and html content of the body of your email, in addition to the `subject` and `reply-to` parameters. The total collective size of your substitutions may not exceed 10,000 bytes per personalization object.",
optional: true,
},
dynamicTemplateData: {
type: "object",
label: "Dynamic Template Data",
description: "Dynamic template data is available using Handlebars syntax in Dynamic Transactional Templates. This field should be used in combination with a Dynamic Transactional Template, which can be identified by a template_id starting with d-. This field is a collection of key/value pairs following the pattern `\"variable_name\":\"value to insert\"`",
optional: true,
},
templateId: {
propDefinition: [
common.props.sendgrid,
"templateId",
],
optional: true,
},
replyToEmail: {
propDefinition: [
common.props.sendgrid,
"replyToEmail",
],
},
replyToName: {
propDefinition: [
common.props.sendgrid,
"replyToName",
],
},
subject: {
propDefinition: [
common.props.sendgrid,
"subject",
],
},
content: {
propDefinition: [
common.props.sendgrid,
"content",
],
optional: true,
},
attachments: {
propDefinition: [
common.props.sendgrid,
"attachments",
],
},
headers: {
propDefinition: [
common.props.sendgrid,
"headers",
],
},
categories: {
propDefinition: [
common.props.sendgrid,
"categories",
],
},
customArgs: {
propDefinition: [
common.props.sendgrid,
"customArgs",
],
},
sendAt: {
propDefinition: [
common.props.sendgrid,
"sendAt",
],
},
asm: {
propDefinition: [
common.props.sendgrid,
"asm",
],
},
asmGroupId: {
propDefinition: [
common.props.sendgrid,
"asmGroupId",
],
},
asmGroupsToDisplay: {
propDefinition: [
common.props.sendgrid,
"asmGroupsToDisplay",
],
},
ipPoolName: {
propDefinition: [
common.props.sendgrid,
"ipPoolName",
],
},
mailSettings: {
propDefinition: [
common.props.sendgrid,
"mailSettings",
],
},
trackingSettings: {
propDefinition: [
common.props.sendgrid,
"trackingSettings",
],
},
},
async run({ $ }) {
validate.validators.arrayValidator = this.validateArray;
validate.validators.asmValidator = this.validateAsm;
const constraints = {
toEmail: {
email: true,
},
fromEmail: {
email: true,
},
};
if (this.cc) {
constraints.cc = {
arrayValidator: {
value: this.cc,
key: "recipient",
},
};
}
if (this.bcc) {
constraints.bcc = {
arrayValidator: {
value: this.bcc,
key: "recipient",
},
};
}
if (this.asm || this.asmGroupsToDisplay) {
constraints.asm = {
asmValidator: {
asm: this.asm,
asmGroupId: this.asmGroupId,
asmGroupsToDisplay: this.asmGroupsToDisplay,
},
};
}
let attachments = this.convertEmptyStringToUndefined(this.attachments);
if (this.attachments) {
constraints.attachments = {
arrayValidator: {
value: this.attachments,
key: "attachments",
},
};
attachments = this.getArrayObject(this.attachments);
}
if (this.categories) {
constraints.categories = {
type: "array",
};
}
if (this.replyToEmail) {
constraints.replyToEmail = {
email: true,
};
}
this.sendAt = this.convertEmptyStringToUndefined(this.sendAt);
if (this.sendAt != null) {
constraints.sendAt = this.getIntegerGtZeroConstraint();
}
const validationResult = validate(
{
toEmail: this.toEmail,
cc: this.cc,
bcc: this.bcc,
fromEmail: this.fromEmail,
replyToEmail: this.replyToEmail,
attachments: this.attachments,
categories: this.categories,
sendAt: this.sendAt,
},
constraints,
);
this.checkValidationResults(validationResult);
const personalizations = [
{},
];
personalizations[0].to = [
{
email: this.toEmail,
},
];
if (this.toName) {
personalizations[0].to[0].name = this.toName;
}
if (this.cc) {
const ccArray = this.getArrayObject(this.cc);
if (ccArray?.length) {
personalizations[0].cc = ccArray;
}
}
if (this.bcc) {
const bccArray = this.getArrayObject(this.bcc);
if (bccArray?.length) {
personalizations[0].bcc = bccArray;
}
}
if (this.personalizationHeaders) {
personalizations[0].headers = this.convertEmptyStringToUndefined(this.personalizationHeaders);
}
if (this.substitutions) {
personalizations[0].substitutions = this.substitutions;
}
if (this.dynamicTemplateData) {
personalizations[0].dynamic_template_data = this.dynamicTemplateData;
}
const from = {
email: this.fromEmail,
};
if (this.fromName) {
from.name = this.fromName;
}
let replyTo = undefined;
if (this.replyToEmail) {
replyTo = {
email: this.replyToEmail,
};
if (this.replyToName) {
replyTo.name = this.replyToName;
}
}
const config = this.omitEmptyStringValues({
personalizations,
from,
reply_to: replyTo,
subject: this.subject,
content: this.content && [
{
type: "text/html",
value: this.content,
},
],
attachments,
headers: this.headers,
categories: this.categories,
custom_args: this.customArgs,
send_at: this.sendAt,
asm: this.getAsmConfig(),
ip_pool_name: this.ipPoolName,
mail_settings: this.mailSettings,
tracking_settings: this.trackingSettings,
template_id: this.templateId,
});
const resp = await this.sendgrid.sendEmail(config);
$.export("$summary", "Email successfully sent");
return resp;
},
};
Chase Roberts@chsrbrts@benedictevans If you haven’t used @pipedream yet, then you haven’t lived.
✨Ellie Day✨@heyelliedayEvaluation update: @pipedream has quite literally been a dream to work with! I’m excited to leverage this tool for all the various workflows I need to write. I’m currently at 11k invocations a day from the initial workflows I’ve written in the past couple weeks.
Michael Braedley@MBraedleyUpdate: I got it working properly, and it's working so well that I'm dropping IFTTT. @pipedream can do everything that IFTTT basic can, and most (if not all things) IFTTT pro can for free or at a reasonable price if you need it. I am recommending it for basically any power user.
Thomas Cutting@mrthomascuttingWant quick+dirty integrations for a serverless workflow - @pipedream is my new go-to 😃
Matthew Roberts@mattdotrobertsday 013 - finally hit node js. This is the secret sauce of taking #nocode projects that one step further. Pumped about getting deeper into @pipedream now
Kenneth Auchenberg 💭@auchenbergYahoo Pipes is back! Kinda 😍 @pipedream
Raymond Camden 🥑@raymondcamdenAwesome video by the @pipedream folks showing real time twitter sentiment analysis integrated with Google Sheets. This is where Pipedream *really* shines, connecting systems together in easy workflows.
Nacho Caballero@nachocaballeroI couldn't recommend @pipedream more. It's an amazing service to integrate different APIs. Much more powerful than Zapier and more user-friendly than AWS Lambda. I'm very proud to wear this t-shirt #NoCode
Jason Snow@jyksnwDeveloped a working prototype environmental sensor IoT solution with @particle Photon, @pipedream, and @MongoDB with full graphing and alerting in less than a day! All amazing technology, will def. be exploring these more.
Steven Terrana@steven_terrana@burgwyn you've inspired me to finally set up my own blog. I'll make sure my first blog post explains the tech behind the setup. think @obsdmd + @GatsbyJS + @pipedream.
🚄 James Augeri, PhD@DotDotJamesWant to low-code your back end, need more horsepower than @Bubble / @KnackHQ, or just miss Yahoo! Pipes? Check out @PipeDream
Sébastien Chopin@AtinuxGitHub issues should be like @linear_app for maintainers. Looking forward more integrations with GH actions or tools like @pipedream 👀
Raul@raul_predescuIf you're a dev and not using @pipedream, you're missing out. Been using it for months, daily. FREE for devs. Plenty of integrations and good limits. Absolutely love it.
Bruno Skvorc@bitfallsSo @pipedream is pretty amazing. In 3 minutes I just made a flow which adds @rickastley's Never Gonna Give You Up to my @spotify playlist whenever a new pull request arrives in an old repo of mine.
Zach Lanich@ZachLanichUm, wow 🤯 @pipedream
Steven Bell@bellontechI just used @pipedream to build a Shopify App. Wow, they make small backed tasks easy.
Jay Hack 🎩🇺🇸@_jayhack_Very impressed with this bad boi - it reminds me of a @PalantirTech internal tool, but geared towards integrations instead of data analysis and far more customizable. Great expectations here 🚀🤩
Tree Sturgeon 🔥🚴♂️🌳@philsturgeonFor context this is day 2 of a really challenging and stupid migration from Notion to @airtable with disparate/missing data. It's going better than expected and thanks to @pipedream I don't have to bother the iOS dev to add W3W.