← Typeform + Sendoso integrations

Send A Physical Gift With Address Confirmation with Sendoso API on New Submission from Typeform API

Pipedream makes it easy to connect APIs for Sendoso, Typeform and 2,000+ other apps remarkably fast.

Trigger workflow on
New Submission from the Typeform API
Next, do this
Send A Physical Gift With Address Confirmation with the Sendoso API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
4 min
Watch now ➜

Trusted by 800,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

This integration creates a workflow with a Typeform trigger and Sendoso action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Select this integration
  2. Configure the New Submission trigger
    1. Connect your Typeform account
    2. Select a Form
  3. Configure the Send A Physical Gift With Address Confirmation action
    1. Connect your Sendoso account
    2. Configure Via
    3. Select a Group
    4. Select a Touch ID
    5. Configure Name
    6. Configure Address
    7. Optional- Configure Address 1
    8. Configure City
    9. Configure State
    10. Configure Country
    11. Configure ZIP
    12. Optional- Configure Via From
    13. Configure Custom Message
    14. Optional- Select a Address Confirmation Via
    15. Optional- Configure Resume With Unconfirmed Address
    16. Optional- Configure No Address
    17. Optional- Configure Expire After Days
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. Turn on the trigger

Details

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger

Description:Emit new submission
Version:0.0.8
Key:typeform-new-submission

Typeform Overview

With the Typeform API, you can easily create beautiful, interactive forms that
allow people to share their information with you in an engaging way. Here are
some examples of what you can build with the Typeform API:

  • A contact form for your website that allows people to easily get in touch
    with you
  • An order form for your product or service that allows people to place orders
    easily and securely
  • A survey form that allows you to collect data and feedback from people
  • A registration form for your event or conference that allows people to sign
    up easily and securely

Trigger Code

import { createHmac } from "crypto";
import sampleEmit from "./test-event.mjs";
import { uuid } from "uuidv4";
import common from "../common/common.mjs";
import constants from "../../constants.mjs";
import utils from "../common/utils.mjs";

const { typeform } = common.props;
const { parseIsoDate } = utils;

export default {
  ...common,
  key: "typeform-new-submission",
  name: "New Submission",
  version: "0.0.8",
  type: "source",
  description: "Emit new submission",
  props: {
    ...common.props,
    http: {
      type: "$.interface.http",
      customResponse: true,
    },
    db: "$.service.db",
    formId: {
      propDefinition: [
        typeform,
        "formId",
      ],
    },
  },
  methods: {
    ...common.methods,
    generateSecret() {
      return "" + Math.random();
    },
  },
  hooks: {
    ...common.hooks,
    async activate() {
      const secret = this.generateSecret();
      this._setSecret(secret);

      let tag = this._getTag();
      if (!tag) {
        tag = uuid();
        this._setTag(tag);
      }

      return await this.typeform.createHook({
        endpoint: this.http.endpoint,
        formId: this.formId,
        tag,
        secret,
      });
    },
    async deactivate() {
      const tag = this._getTag();

      return await this.typeform.deleteHook({
        formId: this.formId,
        tag,
      });
    },
  },
  async run(event) {
    const {
      body,
      headers,
    } = event;

    const { [constants.TYPEFORM_SIGNATURE]: typeformSignature } = headers;

    if (typeformSignature) {
      const secret = this._getSecret();

      const hmac =
        createHmac(constants.ALGORITHM, secret)
          .update(body)
          .digest(constants.ENCODING);

      const signature = `${constants.ALGORITHM}=${hmac}`;

      if (typeformSignature !== signature) {
        throw new Error("signature mismatch");
      }
    }

    let formResponseString = "";
    const data = Object.assign({}, body.form_response);
    data.form_response_parsed = {};

    for (let i = 0; i < body.form_response.answers.length; i++) {
      const field = body.form_response.definition.fields[i];
      const answer = body.form_response.answers[i];

      let parsedAnswer;
      let value = answer[answer.type];

      if (value.label) {
        parsedAnswer = value.label;

      } else if (value.labels) {
        parsedAnswer = value.labels.join();

      } else if (value.choice) {
        parsedAnswer = value.choice;

      } else if (value.choices) {
        parsedAnswer = value.choices.join();

      } else {
        parsedAnswer = value;
      }

      data.form_response_parsed[field.title] = parsedAnswer;
      formResponseString += `### ${field.title}\n${parsedAnswer}\n`;
    }

    data.form_response_string = formResponseString;
    data.raw_webhook_event = body;

    if (data.landed_at) {
      data.landed_at = parseIsoDate(data.landed_at);
    }

    if (data.submitted_at) {
      data.submitted_at = parseIsoDate(data.submitted_at);
    }

    data.form_title = body.form_response.definition.title;
    delete data.answers;
    delete data.definition;

    this.$emit(data, {
      summary: JSON.stringify(data),
      id: data.token,
    });

    this.http.respond({
      status: 200,
    });
  },
  sampleEmit,
};

Trigger Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.
LabelPropTypeDescription
TypeformtypeformappThis component uses the Typeform app.
N/Ahttp$.interface.httpThis component uses $.interface.http to generate a unique URL when the component is first instantiated. Each request to the URL will trigger the run() method of the component.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
FormformIdstringSelect a value from the drop down menu.

Trigger Authentication

Typeform uses OAuth authentication. When you connect your Typeform account, Pipedream will open a popup window where you can sign into Typeform and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Typeform API.

Pipedream requests the following authorization scopes when you connect your account:

offlineaccounts:readforms:writeforms:readimages:writeimages:readthemes:writethemes:readresponses:readresponses:writewebhooks:readwebhooks:writeworkspaces:readworkspaces:write

About Typeform

Typeform lets you build no-code forms, quizzes, and surveys - and get more responses.

Action

Description:Send a physical gift. [See the docs here](https://sendoso.docs.apiary.io/#reference/send-management/send-a-gift/sending-a-gift)
Version:0.0.1
Key:sendoso-send-physical-gift-with-address-confirmation

Sendoso Overview

The Sendoso API provides an easy-to-use platform to quickly and effectively
send physical gifts, cards, and other items to your customers, vendors, or
other key stakeholders. With the Sendoso API, you can build powerful customer
engagement campaigns that include personalized physical gifts and gestures.

The following are some of the things you can build using the Sendoso API:

  • Personalized bulk mailing campaigns, such as holiday cards or special
    occasion items
  • Targeted customer experience campaigns that incorporate a unique physical
    gift directly related to the customer journey
  • Automated thank you packages for key customers and vendors
  • Email programs that include personalized physical products
  • Invitation and promotional campaigns that incorporate physical gifts
  • Corporate gifting programs for employee recognition or development

Action Code

import sendoso from "../../sendoso.app.mjs";

export default {
  key: "sendoso-send-physical-gift-with-address-confirmation",
  name: "Send A Physical Gift With Address Confirmation",
  version: "0.0.1",
  description: "Send a physical gift. [See the docs here](https://sendoso.docs.apiary.io/#reference/send-management/send-a-gift/sending-a-gift)",
  type: "action",
  props: {
    sendoso,
    via: {
      propDefinition: [
        sendoso,
        "via",
      ],
    },
    groupId: {
      propDefinition: [
        sendoso,
        "groupId",
      ],
    },
    touchId: {
      propDefinition: [
        sendoso,
        "touchId",
        (c) => ({
          groupId: c.groupId,
        }),
      ],
      description: "The ID of the touch to be sent on this gift",
    },
    name: {
      type: "string",
      label: "Name",
      description: "The name of the person receiving the gift.",
    },
    address: {
      type: "string",
      label: "Address",
      description: "The first line of the street address.",
    },
    address1: {
      type: "string",
      label: "Address 1",
      description: "The second line of the street address if applicable.",
      optional: true,
    },
    city: {
      type: "string",
      label: "City",
      description: "City of recipients address.",
    },
    state: {
      type: "string",
      label: "State",
      description: "US state of the address (International sending is not available via API at this time).",
    },
    country: {
      type: "string",
      label: "Country",
      description: "E.g. USA",
    },
    zip: {
      type: "string",
      label: "ZIP",
      description: "Zip code of recipients shipping address.",
    },
    viaFrom: {
      propDefinition: [
        sendoso,
        "viaFrom",
      ],
      optional: true,
    },
    customMessage: {
      type: "string",
      label: "Custom Message",
      description: "A freeform text message to be sent along with the gift.",
    },
    addressConfirmationVia: {
      type: "string",
      label: "Address Confirmation Via",
      description: "How the recipient will be asked to confirm their address. Options are `email`, which sends recipient an email, or `link` which provides a link in the response and sends a link to the sender's email address.",
      optional: true,
      options: [
        "email",
        "link",
      ],
    },
    resumeWithUnconfirmedAddress: {
      type: "boolean",
      label: "Resume With Unconfirmed Address",
      description: "Whether or not the gift should be sent if the user does NOT confirm their address.",
      optional: true,
    },
    noAddress: {
      type: "boolean",
      label: "No Address",
      description: "Indicates whether the recipients address is provided or not. When true, will request an address from the recipient either via link or email. Note, if selected email is a required field.",
      optional: true,
    },
    expireAfterDays: {
      type: "integer",
      label: "Expire After Days",
      description: "Sets the number of days the AC form will be valid. Valid values are 2 - 7 inclusive.",
      min: 2,
      max: 7,
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      via,
      touchId,
      name,
      address,
      address1,
      city,
      state,
      country,
      zip,
      viaFrom,
      customMessage,
      addressConfirmationVia,
      resumeWithUnconfirmedAddress,
      noAddress,
      expireAfterDays,
    } = this;

    const response = await this.sendoso.sendGift({
      $,
      via,
      touch_id: touchId,
      name,
      address,
      address1,
      city,
      state,
      country,
      zip,
      via_from: viaFrom,
      custom_message: customMessage,
      confirm_address: "TRUE",
      address_confirmation_via: addressConfirmationVia,
      resume_with_unconfirmed_address: resumeWithUnconfirmedAddress,
      no_address: noAddress,
      expire_after_days: expireAfterDays,
    });

    $.export("$summary", `Gift sent successfully with Tracking Code: ${response.tracking_code}!`);
    return response;
  },
};

Action Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

LabelPropTypeDescription
SendososendosoappThis component uses the Sendoso app.
Viaviastring

Specify you want to generate gift links.

GroupgroupIdintegerSelect a value from the drop down menu.
Touch IDtouchIdintegerSelect a value from the drop down menu.
Namenamestring

The name of the person receiving the gift.

Addressaddressstring

The first line of the street address.

Address 1address1string

The second line of the street address if applicable.

Citycitystring

City of recipients address.

Statestatestring

US state of the address (International sending is not available via API at this time).

Countrycountrystring

E.g. USA

ZIPzipstring

Zip code of recipients shipping address.

Via FromviaFromstring

Specify the name of your Company or Application.

Custom MessagecustomMessagestring

A freeform text message to be sent along with the gift.

Address Confirmation ViaaddressConfirmationViastringSelect a value from the drop down menu:emaillink
Resume With Unconfirmed AddressresumeWithUnconfirmedAddressboolean

Whether or not the gift should be sent if the user does NOT confirm their address.

No AddressnoAddressboolean

Indicates whether the recipients address is provided or not. When true, will request an address from the recipient either via link or email. Note, if selected email is a required field.

Expire After DaysexpireAfterDaysinteger

Sets the number of days the AC form will be valid. Valid values are 2 - 7 inclusive.

Action Authentication

Sendoso uses OAuth authentication. When you connect your Sendoso account, Pipedream will open a popup window where you can sign into Sendoso and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Sendoso API.

Pipedream requests the following authorization scopes when you connect your account:

publicwriteupdate

About Sendoso

Sending platform

More Ways to Connect Sendoso + Typeform

Create a Form with Typeform API on New Send Created from Sendoso API
Sendoso + Typeform
 
Try it
Create an Image with Typeform API on New Send Created from Sendoso API
Sendoso + Typeform
 
Try it
Delete Form with Typeform API on New Send Created from Sendoso API
Sendoso + Typeform
 
Try it
Delete an Image with Typeform API on New Send Created from Sendoso API
Sendoso + Typeform
 
Try it
Duplicate a Form with Typeform API on New Send Created from Sendoso API
Sendoso + Typeform
 
Try it
New Submission from the Typeform API

Emit new submission

 
Try it
New Send Created from the Sendoso API

Emit new event when a new send is created. See docs here

 
Try it
New Send Status Updated from the Sendoso API

Emit new event when a send status is updated. See docs here

 
Try it
Create a Form with the Typeform API

Creates a form with its corresponing fields. See the docs here

 
Try it
Create an Image with the Typeform API

Adds an image in your Typeform account. See the docs here

 
Try it
Delete an Image with the Typeform API

Deletes an image from your Typeform account. See the docs here

 
Try it
Delete Form with the Typeform API

Select a form to be deleted. See the docs here.

 
Try it
Duplicate a Form with the Typeform API

Duplicates an existing form in your Typeform account and adds "(copy)" to the end of the title. See the docs here

 
Try it

Explore Other Apps

1
-
24
of
2,000+
apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.
Google Drive
Google Drive
Google Drive is a file storage and synchronization service which allows you to create and share your work online, and access your documents from anywhere.
Google Sheets
Google Sheets
Use Google Sheets to create and edit online spreadsheets. Get insights together with secure sharing in real-time and from any device.
Filter
Filter
Specify a condition that your workflow must meet and whether you'd like to proceed or end workflow execution.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Data Stores
Data Stores
Use Pipedream Data Stores to manage state throughout your workflows.
GitHub
GitHub
Where the world builds software. Millions of developers and companies build, ship, and maintain their software on GitHub—the largest and most advanced development platform in the world.
Formatting
Formatting
Pre-built actions to make formatting and manipulating data within your workflows easier.
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Airtable (OAuth)
Airtable (OAuth)
Airtable is a low-code platform to build next-gen apps. Move beyond rigid tools, operationalize your critical data, and reimagine workflows with AI.
Zoom
Zoom
Zoom is the leader in modern enterprise video communications, with an easy, reliable cloud platform for video and audio conferencing, chat, and webinars.
Google Calendar
Google Calendar
With Google Calendar, you can quickly schedule meetings and events and get reminders about upcoming activities, so you always know what’s next.
Gmail
Gmail
Gmail offers private and secure email by Google at no cost, for business and consumer accounts.
Gmail (Developer App)
Gmail (Developer App)
Private and secure email by Google at no cost, for business and consumer accounts. Use this app to connect your own developer account credentials.
Email
Email
Trigger workflows on new emails, and send emails to yourself as part of a Pipedream workflow.
Delay
Delay
Delay, pause, suspend, or have the execution of your workflow wait for as little as one millisecond, or as long as one year.
Go
Go
Anything you can do in Go, you can do in a Pipedream Workflow. You can use any of Go packages available with a simple import.
Premium
Zoom Admin
Zoom Admin
Video conferencing (includes account-level scopes) for Zoom Admins.
Twilio
Twilio
Twilio is a cloud communications platform for building SMS, Voice & Messaging applications on an API built for global scale.
Bash
Bash
Run any Bash in a Pipedream step within your workflow, including making curl requests.