Create Client with RiskAdvisor API on New Pin Event from Pinterest API

Pipedream makes it easy to connect APIs for RiskAdvisor, Pinterest and 2,700+ other apps remarkably fast.

Trigger workflow on

New Pin Event from the Pinterest API

Next, do this

Create Client with the RiskAdvisor 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 Pinterest trigger and RiskAdvisor action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the New Pin Event trigger
1. Connect your Pinterest account
2. Configure timer
3. Select a Board ID
4. Optional- Select a Board Section ID
Configure the Create Client action
1. Connect your RiskAdvisor account
2. Configure First Name
3. Configure Last Name
4. Configure Phone Number
5. Configure Email
6. Optional- Configure Middle Name
7. Optional- Configure Suffix
8. Optional- Configure Date of Birth
9. Optional- Configure Contact Preference
10. Optional- Configure Gender
11. Optional- Configure Education
12. Optional- Configure Occupation
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 Pin Event on Pinterest

Description:Emit new events when new pins are created on a board or board section. [See the docs here](https://developers.pinterest.com/docs/api/v5/#operation/boards/list_pins) and [here](https://developers.pinterest.com/docs/api/v5/#operation/board_sections/list_pins)

Version:0.1.0

Key:pinterest-new-pin

View on GitHub

Pinterest Overview#

The Pinterest API opens a portal to interact programmatically with Pinterest's rich data, including boards, pins, and user information. By leveraging this API on Pipedream, you can automate actions like posting new pins, extracting pin data for analysis, and synchronizing Pinterest content with other platforms. The potential extends to marketing optimization, content management, and audience engagement, all automated and integrated within the Pipedream ecosystem.

Trigger Code#

import pinterest from "../../pinterest.app.mjs";
import common from "../common.mjs";

export default {
  key: "pinterest-new-pin",
  name: "New Pin Event",
  description: "Emit new events when new pins are created on a board or board section. [See the docs here](https://developers.pinterest.com/docs/api/v5/#operation/boards/list_pins) and [here](https://developers.pinterest.com/docs/api/v5/#operation/board_sections/list_pins)",
  version: "0.1.0",
  type: "source",
  ...common,
  props: {
    pinterest,
    ...common.props,
    boardId: {
      propDefinition: [
        pinterest,
        "boardId",
      ],
    },
    boardSectionId: {
      propDefinition: [
        pinterest,
        "boardSectionId",
        (configuredProps) => ({
          boardId: configuredProps.boardId,
        }),
      ],
    },
  },
  methods: {
    ...common.methods,
    getResourceFn() {
      return this.pinterest.getPins;
    },
    getResourceFnArgs() {
      return {
        boardId: this.boardId,
        boardSectionId: this.boardSectionId,
      };
    },
    getSummary(item) {
      return `New pin ${item.title} (ID:${item.id})`;
    },
    compareFn(item) {
      return new Date(item.created_at).getTime() > this.getLastFetchTime();
    },
  },
};

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
Pinterest	`pinterest`	`app`	This component uses the Pinterest app.
	`timer`	`$.interface.timer`
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
Board ID	`boardId`	`string`	Select a value from the drop down menu.
Board Section ID	`boardSectionId`	`string`	Select a value from the drop down menu.

Trigger Authentication#

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

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

boards:readboards:read_secretboards:writeboards:write_secretpins:readpins:read_secretpins:writepins:write_secretuser_accounts:read

About Pinterest#

Pinterest is a visual discovery engine for finding ideas like recipes, home and style inspiration, and more.

Action#

Create Client on RiskAdvisor

Description:Create a new client in RiskAdvisor. [See the documentation](https://api.riskadvisor.insure/clients#create-a-client)

Version:0.0.1

Key:riskadvisor-create-client

View on GitHub

RiskAdvisor Overview#

The RiskAdvisor API offers a way to integrate insurance advisory services into your applications seamlessly. By leveraging this API within Pipedream, you can automate the process of obtaining insurance quotes, processing claims, and providing personalized insurance advice. Pipedream's serverless execution environment allows you to create workflows that react to various triggers (such as webhooks, emails, or schedules) and interact with the RiskAdvisor API to carry out tasks without manual intervention. This can streamline operations for insurance agencies, fintech apps, or any business that needs to integrate insurance-related services.

Action Code#

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

export default {
  key: "riskadvisor-create-client",
  name: "Create Client",
  description: "Create a new client in RiskAdvisor. [See the documentation](https://api.riskadvisor.insure/clients#create-a-client)",
  version: "0.0.1",
  type: "action",
  props: {
    riskadvisor,
    firstName: {
      propDefinition: [
        riskadvisor,
        "firstName",
      ],
    },
    lastName: {
      propDefinition: [
        riskadvisor,
        "lastName",
      ],
    },
    phoneNumber: {
      propDefinition: [
        riskadvisor,
        "phoneNumber",
      ],
    },
    email: {
      propDefinition: [
        riskadvisor,
        "email",
      ],
    },
    middleName: {
      propDefinition: [
        riskadvisor,
        "middleName",
      ],
    },
    suffix: {
      propDefinition: [
        riskadvisor,
        "suffix",
      ],
    },
    dateOfBirth: {
      propDefinition: [
        riskadvisor,
        "dateOfBirth",
      ],
    },
    contactPreference: {
      propDefinition: [
        riskadvisor,
        "contactPreference",
      ],
    },
    gender: {
      propDefinition: [
        riskadvisor,
        "gender",
      ],
    },
    education: {
      propDefinition: [
        riskadvisor,
        "education",
      ],
    },
    occupation: {
      propDefinition: [
        riskadvisor,
        "occupation",
      ],
    },
  },
  async run({ $ }) {
    const response = await this.riskadvisor.createClient({
      data: {
        first_name: this.firstName,
        last_name: this.lastName,
        phone_number: this.phoneNumber,
        email: this.email,
        middle_name: this.middleName,
        suffix: this.suffix,
        date_of_birth: this.dateOfBirth,
        contact_preference: this.contactPreference,
        gender: this.gender,
        education: this.education,
        occupation: this.occupation,
      },
      $,
    });

    if (response?.id) {
      $.export("$summary", `Successfully created client with ID ${response.id}.`);
    }

    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.

Label	Prop	Type	Description
RiskAdvisor	`riskadvisor`	`app`	This component uses the RiskAdvisor app.
First Name	`firstName`	`string`	The first name of the client.
Last Name	`lastName`	`string`	The last name of the client.
Phone Number	`phoneNumber`	`string`	The phone number for the client.
Email	`email`	`string`	The email address of the client.
Middle Name	`middleName`	`string`	The middle name of the client.
Suffix	`suffix`	`string`	The suffix of the client.
Date of Birth	`dateOfBirth`	`string`	The date of birth of the client.
Contact Preference	`contactPreference`	`string`	The client's preferred contact method (i.e. phone or email).
Gender	`gender`	`string`	The client's gender.
Education	`education`	`string`	The client's education level.
Occupation	`occupation`	`string`	The client's occupation.