Create or Update Person with Gainsight API

Pipedream makes it easy to connect APIs for Gainsight and 2,900+ other apps remarkably fast.

Trigger workflow on

HTTP requests, schedules and app events

Next, do this

Create or Update Person with the Gainsight 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#

Create a workflow to Create or Update Person with the Gainsight API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Create or Update Person action
1. Connect your Gainsight account
2. Configure Email
3. Optional- Configure First Name
4. Optional- Configure Last Name
5. Optional- Configure LinkedIn URL
6. Optional- Configure Location
7. Optional- Configure Additional Fields
Select a trigger to run your workflow on HTTP requests, schedules or app events
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Integrations#

Create or Update Person with Gainsight API on New Requests (Payload Only) from HTTP / Webhook API

HTTP / Webhook + Gainsight

Try it

Create or Update Person with Gainsight API on New Submission from Typeform API

Typeform + Gainsight

Try it

Create or Update Person with Gainsight API on New Submission (Instant) from Jotform API

Jotform + Gainsight

Try it

Create or Update Person with Gainsight API on New Scheduled Tasks from Pipedream API

Pipedream + Gainsight

Try it

Create or Update Person with Gainsight API on New Download Counts from npm API

npm + Gainsight

Try it

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is 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.

Create or Update Person on Gainsight

Description:Create or update a person's record. [See the documentation](https://support.gainsight.com/gainsight_nxt/API_and_Developer_Docs/Person_API/People_API_Documentation#Person)

Version:0.0.2

Key:gainsight_nxt-create-or-update-person

View on GitHub

Code#

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

export default {
  key: "gainsight_nxt-create-or-update-person",
  name: "Create or Update Person",
  description: "Create or update a person's record. [See the documentation](https://support.gainsight.com/gainsight_nxt/API_and_Developer_Docs/Person_API/People_API_Documentation#Person)",
  version: "0.0.2",
  annotations: {
    destructiveHint: true,
    openWorldHint: true,
    readOnlyHint: false,
  },
  type: "action",
  props: {
    app,
    email: {
      type: "string",
      label: "Email",
      description: "The email address of the person. If a record with this email exists, it will be updated, otherwise a new one will be created.",
    },
    firstName: {
      type: "string",
      label: "First Name",
      description: "The first name of the person.",
      optional: true,
    },
    lastName: {
      type: "string",
      label: "Last Name",
      description: "The last name of the person.",
      optional: true,
    },
    linkedinUrl: {
      type: "string",
      label: "LinkedIn URL",
      description: "The LinkedIn URL of the person.",
      optional: true,
    },
    location: {
      type: "string",
      label: "Location",
      description: "The location of the person.",
      optional: true,
    },
    additionalFields: {
      type: "object",
      label: "Additional Fields",
      description: "Additional fields to include in the request body. [See the documentation](https://support.gainsight.com/gainsight_nxt/API_and_Developer_Docs/Person_API/People_API_Documentation#Person) for all available fields.",
      optional: true,
    },
  },
  async run({ $ }) {
    const response = await this.app.createOrUpdatePerson({
      $,
      data: {
        Email: this.email,
        FirstName: this.firstName,
        LastName: this.lastName,
        LinkedinUrl: this.linkedinUrl,
        Location: this.location,
        ...this.additionalFields,
      },
    });

    $.export("$summary", `Successfully upserted person with email ${this.email}`);
    return response;
  },
};

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
Gainsight	`app`	`app`	This component uses the Gainsight app.
Email	`email`	`string`	The email address of the person. If a record with this email exists, it will be updated, otherwise a new one will be created.
First Name	`firstName`	`string`	The first name of the person.
Last Name	`lastName`	`string`	The last name of the person.
LinkedIn URL	`linkedinUrl`	`string`	The LinkedIn URL of the person.
Location	`location`	`string`	The location of the person.
Additional Fields	`additionalFields`	`object`	Additional fields to include in the request body. See the documentation for all available fields.