Create an Image with Typeform API on New Response from SurveyMethods API

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

Trigger workflow on

New Response from the SurveyMethods API

Next, do this

Create an Image with the Typeform API

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

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

Select this integration
Configure the New Response trigger
1. Connect your SurveyMethods account
2. Configure timer
3. Select a Survey Code
Configure the Create an Image action
1. Connect your Typeform account
2. Configure File name
3. Optional- Configure Base64 image
4. Optional- Configure Image's URL
Deploy the workflow
Send a test event to validate your setup
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#

New Response on SurveyMethods

Description:Emit new event for each response.

Version:0.0.3

Key:surveymethods-new-response

View on GitHub

SurveyMethods Overview#

The SurveyMethods API allows users to automate the management and analysis of surveys and the corresponding data. With the Pipedream integration, you can trigger workflows based on survey events, sync survey results with other databases or apps, and manage survey distribution programmatically. This serves to streamline the survey process from distribution to data actioning, all in real-time and without the need for manual intervention.

Trigger Code#

import surveymethods from "../../surveymethods.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

export default {
  name: "New Response",
  version: "0.0.3",
  key: "surveymethods-new-response",
  description: "Emit new event for each response.",
  type: "source",
  dedupe: "unique",
  props: {
    surveymethods,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      static: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    surveyCode: {
      propDefinition: [
        surveymethods,
        "surveyCode",
      ],
    },
  },
  hooks: {
    async deploy() {
      const responses = await this.surveymethods.getResponses({
        surveyCode: this.surveyCode,
        perPage: 10,
      });

      responses.reverse().forEach(this.emitEvent);
    },
  },
  methods: {
    async emitEvent(data) {
      this.$emit(data, {
        id: data.code,
        summary: `New response with code ${data.code}`,
        ts: Date.parse(data.created_date),
      });
    },
  },
  async run() {
    let page = 1;

    while (page >= 0) {
      const responses = await this.surveymethods.getResponses({
        surveyCode: this.surveyCode,
        page,
        perPage: 100,
      });

      responses.reverse().forEach(this.emitEvent);

      if (responses.length < 100) {
        return;
      }

      page++;
    }
  },
};

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.

Label	Prop	Type	Description
SurveyMethods	`surveymethods`	`app`	This component uses the SurveyMethods app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Survey Code	`surveyCode`	`string`	Select a value from the drop down menu.

Trigger Authentication#

SurveyMethods uses API keys for authentication. When you connect your SurveyMethods account, Pipedream securely stores the keys so you can easily authenticate to SurveyMethods APIs in both code and no-code steps.

Use your account email address as your Login ID.
To get your API Key, follow the below steps:

Log in to your SurveyMethods account using your login id and password. The email
address that you provide during the registration will be your login id.
Go to the My Account Section.
Click on the API tab.

About SurveyMethods#

SurveyMethods provides powerful online survey software tool, advanced data analysis, email newsletters, and a comprehensive survey API.

Action#

Create an Image on Typeform

Description:Adds an image in your Typeform account. [See the docs here](https://developer.typeform.com/create/reference/create-image/)

Version:0.0.2

Key:typeform-create-image

View on GitHub

Typeform Overview#

The Typeform API furnishes you with the means to create dynamic forms and collect user responses in real-time. By leveraging this API within Pipedream's serverless platform, you can automate workflows to process this data, integrate seamlessly with other services, and react to form submissions instantaneously. This empowers you to craft tailored responses, synchronize with databases, trigger email campaigns, or even manage event registrations without manual intervention.

Action Code#

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

export default {
  key: "typeform-create-image",
  name: "Create an Image",
  description: "Adds an image in your Typeform account. [See the docs here](https://developer.typeform.com/create/reference/create-image/)",
  type: "action",
  version: "0.0.2",
  props: {
    typeform,
    fileName: {
      type: "string",
      label: "File name",
      description: "File name for the image",
    },
    image: {
      type: "string",
      label: "Base64 image",
      description: "Base64 code for the image. Note that base64 encoders may add descriptors to the code (such as `data:image/png;base64,`). Do not include these descriptors in your image string---include only the base64 code. We also recommend that you don't paste the exact string value into this property box. Instead you can [pass an expression](https://pipedream.com/docs/workflows/steps/params/#entering-expressions) that references a variable from a previous step such as `{{steps.nodejs.$return_value}}`.",
      optional: true,
    },
    url: {
      type: "string",
      label: "Image's URL",
      description: "URL of the image to be added in your Typeform account",
      optional: true,
    },
  },
  async run({ $ }) {
    if (!this.image && !this.url) {
      throw new Error("This action requires either Base64 image or Image's URL. Please enter one or the other above.");
    }

    const data = {
      file_name: this.fileName,
      image: this.image,
      url: this.url,
    };

    const resp = await this.typeform.createImage({
      $,
      data,
    });

    $.export("$summary", "Successfully added a new image to your account");

    return resp;
  },
};

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.

Label	Prop	Type	Description
Typeform	`typeform`	`app`	This component uses the Typeform app.
File name	`fileName`	`string`	File name for the image
Base64 image	`image`	`string`	Base64 code for the image. Note that base64 encoders may add descriptors to the code (such as `data:image/png;base64,`). Do not include these descriptors in your image string---include only the base64 code. We also recommend that you don't paste the exact string value into this property box. Instead you can pass an expression that references a variable from a previous step such as `{{steps.nodejs.$return_value}}`.
Image's URL	`url`	`string`	URL of the image to be added in your Typeform account

Action 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