actions/create-customer/create-customer.mjs
import { ConfigurationError } from "@pipedream/platform"; import { GENDER_OPTIONS, PHOTO_TYPE_OPTIONS, } from "../../common/constants.mjs"; import { cleanObject, parseObject, } from "../../common/utils.mjs"; import helpScout from "../../help_scout.app.mjs"; export default { key: "help_scout-create-customer", name: "Create Customer", description: "Creates a new customer record in Help Scout. [See the documentation](https://developer.helpscout.com/mailbox-api/endpoints/customers/create/)", version: "0.0.3", annotations: { destructiveHint: false, openWorldHint: true, readOnlyHint: false, }, type: "action", props: { helpScout, firstName: { type: "string", label: "First Name", description: "First name of the customer. When defined it must be between 1 and 40 characters.", optional: true, }, lastName: { type: "string", label: "Last Name", description: "Last name of the customer. When defined it must be between 1 and 40 characters.", optional: true, }, phone: { type: "string", label: "Phone", description: "The phone number that will be used when creating a new customer.", optional: true, }, photoUrl: { type: "string", label: "Photo URL", description: "URL of the customer's photo. Max length 200 characters.", optional: true, }, jobTitle: { type: "string", label: "Job Title", description: "Job title. Max length 60 characters.", optional: true, }, photoType: { type: "string", label: "Photo Type", description: "The type of photo.", options: PHOTO_TYPE_OPTIONS, optional: true, }, background: { type: "string", label: "Background", description: "This is the Notes field from the user interface. Max length 200 characters.", optional: true, }, location: { type: "string", label: "Location", description: "Location of the customer. Max length 60 characters.", optional: true, }, organization: { type: "string", label: "Organization", description: "Organization. Max length 60 characters.", optional: true, }, gender: { type: "string", label: "Gender", description: "Gender of this customer.", options: GENDER_OPTIONS, optional: true, }, age: { type: "string", label: "Age", description: "Customer's age.", optional: true, }, emails: { type: "string[]", label: "Emails", description: "List of email entries. **Format: {\"type\":\"home\",\"value\":\"customer@email.com\"}**. see [Create Email](https://developer.helpscout.com/mailbox-api/endpoints/customers/emails/create) for the object documentation.", optional: true, }, phones: { type: "string[]", label: "Phones", description: "List of phone entries. **Format: {\"type\":\"work\",\"value\":\"222-333-4444\"}**. see [Create Phone](https://developer.helpscout.com/mailbox-api/endpoints/customers/phones/create) for the object documentation.", optional: true, }, chats: { type: "string[]", label: "Chats", description: "List of chat entries. **Format: {\"type\":\"aim\",\"value\":\"jsprout\"}**. see [Create Chat Handle](https://developer.helpscout.com/mailbox-api/endpoints/customers/chat_handles/create) for the object documentation.", optional: true, }, socialProfiles: { type: "string[]", label: "Social Profiles", description: "List of social profile entries. **Format: {\"type\":\"googleplus\",\"value\":\"https://api.helpscout.net/+HelpscoutNet\"}**. see [Create Social Profile](https://developer.helpscout.com/mailbox-api/endpoints/customers/social_profiles/create) for the object documentation.", optional: true, }, websites: { type: "string[]", label: "Websites", description: "List of websites entries. **Format: {\"value\":\"https://api.helpscout.net/\"}**. see [Create Website](https://developer.helpscout.com/mailbox-api/endpoints/customers/websites/create) for the object documentation.", optional: true, }, addressCity: { type: "string", label: "Address City", description: "The city of the customer.", optional: true, }, addressState: { type: "string", label: "Address State", description: "The state of the customer.", optional: true, }, addressPostalCode: { type: "string", label: "Address Postal Code", description: "The postal code of the customer.", optional: true, }, addressCountry: { type: "string", label: "Address Country", description: "The [ISO 3166 Alpha-2 code](https://www.iban.com/country-codes) country of the customer.", optional: true, }, addressLines: { type: "string[]", label: "Address Lines", description: "A list of address lines.", optional: true, }, properties: { type: "string[]", label: "Properties", description: "List of social profile entries. **Format: {\"type\":\"googleplus\",\"value\":\"https://api.helpscout.net/+HelpscoutNet\"}**. see [Create Social Profile](https://developer.helpscout.com/mailbox-api/endpoints/customers/social_profiles/create) for the object documentation.", optional: true, }, }, async run({ $ }) { const address = cleanObject({ city: this.addressCity, state: this.addressState, postalCode: this.addressPostalCode, country: this.addressCountry, lines: parseObject(this.addressLines), properties: parseObject(this.properties), }); let data = {}; data = cleanObject({ firstName: this.firstName, lastName: this.lastName, phone: this.phone, photoUrl: this.photoUrl, jobTitle: this.jobTitle, photoType: this.photoType, background: this.background, location: this.location, organization: this.organization, gender: this.gender, age: this.age, emails: parseObject(this.emails), phones: parseObject(this.phones), chats: parseObject(this.chats), socialProfiles: parseObject(this.socialProfiles), websites: parseObject(this.websites), }); if (Object.keys(address).length) data.address = address; if (!Object.keys(data).length) { throw new ConfigurationError("At least one field or customer entry must be defined."); } try { const response = await this.helpScout.createCustomer({ $, data, }); $.export("$summary", "Successfully created the new customer."); return response; } catch ({ message }) { const error = JSON.parse(message)._embedded.errors[0]; throw new ConfigurationError(`Path: ${error.path} - ${error.message}`); } }, };
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.