People API Documentation

Method

PUT

Endpoint URL

https://v1/peoplemgmt/v1.0/people

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only
• people represents insert or update a record in the Person object model.

Sample Request Body

A new person record that has no company or relationship associations can be inserted into the Person object. Pass a record that you want to insert into the Person object in the request body. Fields in the object and their associated values are passed as key value pairs as shown below. Pass the record that needs to be inserted as an array item.

Notes:

• Passing an Email of a person is mandatory, it is used as a unique constraint to resolve an existing record in the Person object.
• If you pass a record, the Email of which matches with the existing record in the Person object, remaining fields in the existing record are updated with other details.

{
  "FirstName": "John",
  "LastName": "Smith",
  "Email": "jsmith@abc.com"
}

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

Successful API request will return HTTP status code 200 as response. Format of the response is as shown below. Success response contains unique GSID of new record from the Person object.

{
  "result": true,
  "requestId": "ffad9762-4b55-424f-b9d4-f7c5f634752b",
  "data": {
    "record": {
      "emailoptout": false,
      "createdby": "1P013MQAG8HNIY3NZ4AAA11VYQ2OHJ94A9H",
      "email": "t@t.com",
      "createddate": "2022-10-31T05:38:32.034",
      "modifiedby": "1P013MQAG8HNIY3NZAA11VYQ2OHJ94A9H",
      "name": "abc",
      "gsid": "1P0452MXO8N9COP0OCGAAAJCA7X3ZVEZ",
      "modifieddate": "2022-10-31T05:44:19.862",
      "companies": [
        {
          "person_id": {
            "Id": "1P0452MXO8N9COP0OAAIQY7JCA7X3ZVEZ",
            "name": "abc"
          },
          "company_id": {
            "Id": "1P02URY3JWNYZJWFIAAA2XA7VS0IO49MIO",
            "name": "unilever"
          },
          "modifiedby": "1P013MQAG8HNIY3NZAAAU11VYQ2OHJ94A9H",
          "createdby": "1P013MQAG8HNIY3AAAG4U11VYQ2OHJ94A9H",
          "createddate": "2022-10-31T05:38:32.74",
          "active": true,
          "modifieddate": "2022-10-31T05:38:32.74",
          "gsid": "1C013F7LHUKCPMTLKZAAAAMIDM501AD23NCX"
        }
      ]
    }
  }
}

Sample Failure Response

{
  "result": false,
  "requestId": "831b395b-9467-43f4-a912-7ca21d6e761f",
  "data": {
    "error": {
      "details": [
        {
          "errors": [
            {
              "message": "Upsert Keys '[Email]' values empty or null",
              "code": "GSOBJ_VCR1008"
            }
          ]
        }
      ]
    }
  }
}

Method

PUT

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only
• people represents insert or update a record in the Person object model.

Sample Request Body

Pass a record that you want to insert into the Person, Company Person, and Relationship Person objects in the request body. Fields in an object and their associated values are passed as key value pairs as shown below. Pass the record that needs to be inserted as an array item. While inserting a record into the Company Person and Relationship objects, it fetches GSID from Person object using Email as a unique constraint and updates other fields in the Person object with the provided details.

If you pass an Email of a person record through the API which is not available in the Person object, a new record is created in the Person object.  If you pass a record, Email/Person ID and Company ID/Company lookup details of which matches with the existing records in the Person and Company Person objects, remaining fields in the existing record can be updated with other details. Similarly using Email/Person ID and Relationship ID/Relationship lookup details as unique constraints, existing records in the Person and Relationship Person can be updated.

{
    "FirstName": "John",
    "LastName": "Smith",
    "Email": "jsmith@abc.com",
    "companies": [
        {
            "Company_ID":"1I00V4ALRX6A6ZOEQ0FNJ3CXSRAVFFWJCCCA",
            "IsPrimaryCompany": "false"
        },
        {
            "Company_ID":"2J33V5ALRX6A6ZOEQ0FNJ3CXSRAVFFWJBBBD",
            "IsPrimaryCompany": "true",
            "relationships": [
                {
                  "Role": "Admin",
                  "IsPrimaryCompany": "true",
                  "Relationship_ID": "1I00V4ALRX6A6ZOEQ0FNJ3CXSRAVFFWJAAA2"

        }
        ]
    }
  ] 
}

{
  "FirstName": "John",
  "LastName": "Smith",
  "Email": "jsmith@abc.com",
  "companies": [
    {
      "CompanyName": "Drivedata",
      "IsPrimaryCompany": "false",
      "role": "Power User",
      "CustomObject__column1": 9234567891
    },
    {
      "CompanyName": "abc, Inc.",
      "IsPrimaryCompany": "true",
      "Relationships": [
        {
          "role": "Admin",
          "IsPrimaryCompany": "true",
          "RelationshipName": "Asia Pacific"
        }
      ]
    }
  ],
  "lookups": {
    "companies": {
      "Company_ID": {
        "fields": {
          "CompanyName": "Name"
        },
        "lookupField": "Gsid",
        "objectName": "Company",
        "multiMatchOption": "FIRSTMATCH",
        "onNoMatch": "ERROR"
      },
      "Deskphone__gc": {
        "fields": {
          "CustomObject__column1": "Phone_num_custom_column"
        },
        "lookupField": "Gsid",
        "objectName": "custom_table_name",
        "multiMatchOption": "FIRSTMATCH",
        "onNoMatch": "ERROR"
      }
    },
    "relationships": {
      "Relationship_ID": {
        "fields": {
          "RelationshipName": "Name"
        },
        "lookupField": "Gsid",
        "objectName": "Relationship",
        "multiMatchOption": "FIRSTMATCH",
        "onNoMatch": "ERROR"
      }
    }
  }
}

{
  "lookups": {
    "companies": {
      "Company_ID": {
        "fields": {
          "CompanyName": "Name"
        },
        "lookupField": "Gsid",
        "objectName": "Company",
        "multiMatchOption": "FIRSTMATCH",
        "onNoMatch": "ERROR"
      },
      "Deskphone__gc": {
        "fields": {
          "CustomObject__column1": "Phone_num_custom_column"
        },
        "lookupField": "Gsid",
        "objectName": "custom_table_name",
        "multiMatchOption": "FIRSTMATCH",
        "onNoMatch": "ERROR"
      }
    },
    "relationships": {
      "Relationship_ID": {
        "fields": {
          "RelationshipName": "Name"
        },
        "lookupField": "Gsid",
        "objectName": "Relationship",
        "multiMatchOption": "FIRSTMATCH",
        "onNoMatch": "ERROR"
      }
    }
  }
}

{
  "FirstName": "John",
  "LastName": "Smith",
  "Name": "John Smith",
  "Email": "jsmith@abc.com",
  "relationships": [
    {
      "Role": "Admin",
      "IsPrimaryCompany": "true",
      "RelationshipName": "Asia Pacific"
    }
  ],
  "lookups": {
    "relationships": {
      "Relationship_ID": {
        "fields": {
          "RelationshipName": "Name"
        }
      }
    }
  }
}

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

Successful API request will return HTTP status code 200 as response. Format of the response is as shown below. Success response contains unique GSID of a record from the Person object.

{
  "result": true,
  "requestId": "30f39fc7-2ba8-4684-92b5-d2292992ef1c",
  "data": {
    "record": {
      "firstname": "John",
      "emailoptout": false,
      "createdby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
      "email": "jsmith@abc.com",
      "createddate": "2022-10-31T05:52:55.927",
      "modifiedby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
      "name": "John Smith",
      "lastname": "Smith",
      "gsid": "1P0452MXO8N9COP0OCMY6OOCSJ4J9JOD1GSG",
      "modifieddate": "2022-10-31T05:56:29.582",
      "companies": [
        {
          "person_id": {
            "Id": "1P0452MXO8N9COP0OCMY6OOCSJ4J9JOD1GSG",
            "name": "John Smith"
          },
          "isprimarycompany": false,
          "modifiedby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
          "createdby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
          "createddate": "2022-10-31T05:52:55.986",
          "active": true,
          "modifieddate": "2022-10-31T05:54:57.894",
          "gsid": "1C013F7LHUKCPMTLKZ7SC9H259O4GFEA44ZO"
        },
        {
          "person_id": {
            "Id": "1P0452MXO8N9COP0OCMY6OOCSJ4J9JOD1GSG",
            "name": "John Smith"
          },
          "isprimarycompany": true,
          "modifiedby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
          "createdby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
          "createddate": "2022-10-31T05:52:56.042",
          "active": true,
          "modifieddate": "2022-10-31T05:54:57.941",
          "gsid": "1C013F7LHUKCPMTLKZM9H1VLD7WLAJMEGECB",
          "relationships": [
            {
              "modifiedby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
              "person_id": {
                "Id": "1P0452MXO8N9COP0OCMY6OOCSJ4J9JOD1GSG",
                "name": "John Smith"
              },
              "active": true,
              "role": "1I0054U9FAKXZ0H26H8UXDA0ZVKNQ2SWMBER",
              "isprimarycompany": true,
              "createdby": "1P013MQAG8HNIY3NZ41G4U11VYQ2OHJ94A9H",
              "modifieddate": "2022-10-31T05:54:57.989",
              "gsid": "1C03MYKI9D09MW4JRS9QV0A70LBF62UTM8SA",
              "createddate": "2022-10-31T05:52:56.148",
              "company_person_id": "1C013F7LHUKCPMTLKZM9H1VLD7WLAJMEGECB"
            }
          ]
        }
      ]
    }
  }
}

Sample Failure Response

{
  "result": false,
  "requestId": "e8ad4c82-689b-4ec3-b2e7-87cac173a210",
  "data": {
    "error": {
      "details": [
        {
          "errors": [
            {
              "message": "Upsert Keys '[Email]' values empty or null",
              "code": "GSOBJ_VCR1008"
            }
          ]
        }
      ]
    }
  }
}

Method

PUT

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only
• people represents insert or update a record in the Person, Company Person, and Relationship Person objects.

Sample Request Body

Pass records that you want to insert into the Company Person and Relationship Person objects with only Person ID, Company ID, and Relationship IDs.

A person can be associated with multiple companies. "companies" and "relationships" fields data represents the list of Company and Relationship association records respectively. You can fetch Company ID and Relationship ID using import lookup configuration provided in the API request body. To fetch Company ID, Person ID, and Relationship ID:

• Pass “Email” as a key value pair that helps you to match with the Email field from the Person object using "lookup details" and identify a record in the Person object to tie the person details that are passed in the API.
• In the "companies" field, Pass key value pairs that helps you to match with fields from the Company object using "lookup details" and fetches GSID from the Company object and populate into target field Company ID.Pass search criteria in the Company ID field that works with the lookup configuration provided in the "lookups" field and fetches Company ID (GSID) of a record from the Company object that matches with the lookup search criteria.
• Similarly, you can fetch Relationship ID to the Relationship Person object using import lookup configuration. For more information on the import lookup configuration to load values in the GSID type fields, refer to the section Import Lookup.
• You can also populate values into any custom field of GSID data type using import lookup configuration.
• Passing lookup details like lookupField, objectName, multiMatchOption, onNoMatch is not mandatory to populate GSID into standard fields like Person ID, Company ID, Relationship ID, etc. It is required to pass them for custom fields of GSID data type.
• If you do not pass lookup details, the system considers default options for "multiMatchOption": "FIRSTMATCH" and "onNoMatch": "ERROR".

If you pass a record, Email and Company ID of which matches with the existing record in the Person and Company Person objects, remaining fields in the existing record are updated with other details. Similarly, Email and Relationship ID of the new record matches with the existing record in the Person and Relationship Person objects, remaining fields in the existing record are updated with other details.

Following is the sample Upsert API with lookup details:

• In the "companies" field, "CompanyName" and "PersonEmail" work with lookups configuration to fetch values into the Company ID and Person ID fields. Similarly, "RelationshipName" is provided to fetch a value into the Relationship ID using lookup details.
• Lookup configuration is provided in the "lookups" field as to search for a Name provided in the Company Name, Relationship Name fields in the Company and Relationship objects and fetch Company ID and Relationship ID. Similarly, passed Email matches with the Email in the Person object and fetches existing Person ID into the Company Person and Relationship Person objects. For more information on the import lookup configuration to load values in the GSID type fields, refer to the section Import Lookup.

A sample API:

{
  "companies": [
    {
      "CompanyName": "abc, Inc.",
      "PersonEmail": "jsmith@abc.com",
      "IsPrimaryCompany": "true",
      "relationships": [
        {
          "Role": "Admin",
          "IsPrimaryCompany": "true",
          "RelationshipName": "Asia Pacific"
        }
      ]
    }
  ],
  "lookups": {
    "companies": {
      "Company_ID": {
        "fields": {
          "CompanyName": "Name"
        }
      },
      "Person_ID": {
        "fields": {
          "PersonEmail": "Email"
        }
      }
    },
    "relationships": {
      "Relationship_ID": {
        "fields": {
          "RelationshipName": "Name"
        }
      }
    }
  }
}

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

Successful API request will return HTTP status code 200 as response. Format of the response is as shown below. Success response contains unique GSID of a record from the Person object.

{
    "result": true,
    "requestId": "093e78ca-47a0-4512-bd0f-01ea58e944ef",
    "data": {
        "status": "SUCCESS",
        "personGsid": "1P04QNK6ENCURXXDZW5XK6PQMFFDEBD8EL3K"
    }
}

Sample Failure Response

If your API request results in an error, an error response is returned in the following format. The error response has a Gainsight error code and error description. Gainsight error code and HTTP status code responses can be due to various reasons. For the full list of Gainsight error codes, error descriptions, their reasons, and HTTP status codes, refer to the Error Codes for Person API article available in the Additional Resources section.

In the following error response body, error description shows the reason for failure of this API, with the given Company ID lookup search criteria, no matching record is found in the Company object.

{
    "result": false,
    "requestId": "27b8df50-beed-48c8-9b00-c5aebf9a1bcc",
    "data": {
        "status": "FAILURE",
        "errors": [
            {
                "field": "Company_ID",
                "invalidValue": [
                    {
                      "Email": "abc, Inc.",
                      "Company_ID": "RLS_SOURCE_LOOKUP_FIELD_NOT_RESOLVED"
                    }
                ],
                "errorCode": "RLS_SOURCE_LOOKUP_FIELD_NOT_RESOLVED",
                "errorMessage": "ResolveLookupService source lookup field not resolved"
            }
        ]
    }
}

Upsert Person API

This Upsert API is used to insert or update multiple records into the Person object that are not associated with any Company or Relationship. You can insert a maximum of 50 records per API call.

This API validates all fields in the Person object before inserting or updating the records. Records are inserted or updated when validation is successful. If the validation fails for any record on any field, then those records are not inserted or updated and the API call responds with a validation error.

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people/async

{
  "records": [
    {
      "Name": "John Smith",
      "FirstName": "John",
      "LastName": "Smith",
      "Email": "jsmith@abc.com"
    },
    {
      "Name": "Steven Ferguson",
      "FirstName": "Steven",
      "LastName": "Ferguson",
      "Email": "sferguson@drivedata.com"
    },
    {
      "Name": "Amanda Churchill",
      "FirstName": "Amanda",
      "LastName": "Churchill",
      "Email": "achurchill@simplify.com"
    }
  ]
}

{
    "result": true,
    "requestId": "7581e498-c37e-4057-8fc9-c8d4d543de1a",
    "data": {
        "statusId": "e3f66752-bd71-4826-b9e0-892f7c0a841e"
    }
}

Method

PUT

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people/async

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only.
• people represents insert or update records in the Person object model.
• async: represents a method to insert or update multiple person records through one API call.

Sample Request Body

Pass records that you want to insert into the Person, Company Person, and Relationship Person objects in the request body. Fields in an object and their associated values are passed as key value pairs as shown below. Pass each record that needs to be inserted as an array item. You can pass a maximum of 50 person records per API call.

While upserting a record into the Person object, it fetches GSID from Person object using Email as unique constraint and updates other fields in the Person object with the provided details. If you pass an Email of a person record which is not available in the Person object, a new record is created in the Person object. If you pass a record, Email/Person ID and Company ID/Company lookup details of which matches with the existing record in the Person and Company Person, remaining fields in the existing record are updated with other details. Similarly using Email/Person ID and Relationship ID/Relationship lookup details as unique constraints, existing records in the Person and Relationship Person can be updated.

{
  "records": [
    {
      "Name": "John Smith",
      "FirstName": "John",
      "LastName": "Smith",
      "Email": "jsmith@abc.com",
      "companies": [
        {
          "Company_ID": "7581e498-c37e-4057-8fc9-c8d4d543de1a",
          "IsPrimaryCompany": "true",
          "relationships": [
            {
              "Role": "Admin",
              "IsPrimaryCompany": "true",
              "Relationship_ID": "7581e498-c37e-4057-8fc9-c8d4d543bbbb"
            }
          ]
        }
      ]
    },
    {
      "Name": "Steven Ferguson",
      "FirstName": "Steven",
      "LastName": "Ferguson",
      "Email": "sferguson@drivedata.com",
      "companies": [
        {
          "Company_ID": "7581e498-c37e-4057-8fc9-c8d4d543de1a",
          "IsPrimaryCompany": "true",
          "relationships": [
            {
              "Role": "Executive Sponsor",
              "IsPrimaryCompany": "true",
              "Relationship_ID": "7581e498-c37e-4057-8fc9-c8d4d543bbbb"
            }
          ]
        }
      ]
    },
    {
      "Name": "Amanda Churchill",
      "FirstName": "Amanda",
      "LastName": "Churchill",
      "Email": "achurchill@simplify.com",
      "companies": [
        {
          "Company_ID": "7581e498-c37e-4057-8fc9-c8d4d543de1a",
          "IsPrimaryCompany": "true",
          "relationships": [
            {
              "Role": "Decision Maker",
              "IsPrimaryCompany": "true",
              "Relationship_ID": "7581e498-c37e-4057-8fc9-c8d4d543bbbb"
            }
          ]
        }
      ]
    }
  ]
}

{
  "records": [
    {
      "Name": "John Smith",
      "FirstName": "John",
      "LastName": "Smith",
      "Email": "jsmith@abc.com",
      "companies": [
        {
          "CompanyName": "abc, Inc.",
          "IsPrimaryCompany": "true",
          "relationships": [
            {
              "Role": "Admin",
              "IsPrimaryCompany": "true",
              "RelationshipName": "Asia Pacific"
            }
          ]
        }
      ],
      "lookups": {
        "companies": {
          "Company_ID": {
            "fields": {
              "CompanyName": "Name"
            }
          }
        },
        "relationships": {
          "Relationship_ID": {
            "fields": {
              "RelationshipName": "Name"
            }
          }
        }
      }
    },
    {
      "Name": "Steven Ferguson",
      "FirstName": "Steven",
      "LastName": "Ferguson",
      "Email": "sferguson@drivedata.com",
      "companies": [
        {
          "CompanyName": "Drive Data",
          "IsPrimaryCompany": "true",
          "relationships": [
            {
              "Role": "Executive Sponsor",
              "IsPrimaryCompany": "true",
              "RelationshipName": "South Central"
            }
          ]
        }
      ],
      "lookups": {
        "companies": {
          "Company_ID": {
            "fields": {
              "CompanyName": "Name"
            }
          }
        },
        "relationships": {
          "Relationship_ID": {
            "fields": {
              "RelationshipName": "Name"
            }
          }
        }
      }
    },
    {
      "Name": "Amanda Churchill",
      "FirstName": "Amanda",
      "LastName": "Churchill",
      "Email": "achurchill@simplify.com",
      "companies": [
        {
          "CompanyName": "Simplify, Inc.",
          "IsPrimaryCompany": "true",
          "relationships": [
            {
              "Role": "Decision Maker",
              "IsPrimaryCompany": "true",
              "RelationshipName": "Middle East"
            }
          ]
        }
      ],
      "lookups": {
        "companies": {
          "Company_ID": {
            "fields": {
              "CompanyName": "Name"
            }
          }
        },
        "relationships": {
          "Relationship_ID": {
            "fields": {
              "RelationshipName": "Name"
            }
          }
        }
      }
    }
  ]
}

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

API request will return HTTP status code 200 as response with status Id in the “data”. Format of the response is as shown below. In the following response, value in the “data” key "a679fc3e-2ae6-48c1-95b6-ed82f9b8619e" is status Id. You can pass this status Id in the Endpoint URL of Upsert Status API to get the status of bulk data upsert of person records.

{
    "result": true,
    "requestId": "7581e498-c37e-4057-8fc9-c8d4d543de1a",
    "data": {
        "statusId": "e3f66752-bd71-4826-b9e0-892f7c0a841e"
    }
}

Method

GET

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people/async/status/{statusId}

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only.
• async: represents a method to insert or update multiple person records through one API call.
• statusId: represents the job id that is generated when an Async Upsert API record request is submitted through an API.

With statusId, Endpoint URL looks like /v1/peoplemgmt/v1.0/people/async/status/a679fc3e-2ae6-48c1-95b6-ed82f9b8619e

Sample Request Body

This status API responds with an API response having status of the corresponding API call. You may receive one of the following status:

• INIT (Initiated)
• INPROGRESS
• COMPLETED

Following is the sample API response with status INIT:

{
    "result": true,
    "requestId": "069360c6-03b3-4acf-8c7e-17ae0963ecd2",
    "data": {
        "status": "INIT"
    }
}

Following is the sample API response with status INPROGRESS:

{
    "result": true,
    "requestId": "069360c6-03b3-4acf-8c7e-17ae0963ecd2",
    "data": {
        "status": "INPROGRESS"
    }
}

It may take a maximum of 30 minutes to complete inserting or updating the records. Status is displayed as either INIT or INPROGRESS until the upsert is completed. If the status of API call is COMPLETED, the API response body has the following information:

• Upsert status of each record with either SUCCESS or FAILURE.
• personGsid of each record successfully inserted or updated.
• Error details of the failed upsert of a record like errorCode, errorMessage, and other error details.

For the full list of Gainsight error codes, error descriptions, and their reasons, refer to the Error Codes for Person API article available in the Additional Resources section.

Following is the sample API response with status COMPLETED and SUCCESS in upserting all the records:

{
    "result": true,
    "requestId": "069360c6-03b3-4acf-8c7e-17ae0963ecd2",
    "data": {
        "response": [
            {
                "status": "SUCCESS",
                "personGsid": "1P04FB5W1VECWNJCCVSLYPA6V8DCGNQ58SZ8"
            },
            {
                "status": "SUCCESS",
                "personGsid": "1P04FB5W1VECWNJCCVUISQCMJQ7AR3H72NS8"
            },
            {
                "status": "SUCCESS",
                "personGsid": "1P04FB5W1VECWNJCCVH1M411WI4YP6E2JJSY"
            }
        ],
        "status": "COMPLETED"
    }
}

Following is the sample API response with status COMPLETED and SUCCESS in upserting some records and FAILURE in upserting some records with error details:

{
    "result": true,
    "requestId": "069360c6-03b3-4acf-8c7e-17ae0963ecd2",
    "data": {
        "response": [
            {
                "status": "SUCCESS",
                "personGsid": "1P04FB5W1VECWNJCCVSLYPA6V8DCGNQ58SZ8"
            },
            {
                "status": "SUCCESS",
                "personGsid": "1P04FB5W1VECWNJCCVUISQCMJQ7AR3H72NS8"
            },
            {
                "status": "FAILURE",
                "errors": [
                  {
                "field": "Company_ID",
                "invalidValue": [
                    {
                        "Name": "Simplify, Inc.",
                        "Company_ID":  "RLS_SOURCE_LOOKUP_FIELD_NOT_RESOLVED"
                    }
                ],
                "errorCode": "RLS_SOURCE_LOOKUP_FIELD_NOT_RESOLVED",
                "errorMessage": "ResolveLookupService source lookup field not resolved"
            }
]
            }
        ],
        "status": "COMPLETED"
    }
}

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

{
  "result": true,
  "requestId": "8484e4fa-f520-4cdc-a4a4-acbec39a0648",
  "data": {
    "errors": [
      {
        "details": [
          {
            "errors": [
              {
                "message": "Internal server error",
                "code": "GSOBJ_PEOPLE1002"
              }
            ]
          }
        ]
      }
    ]
  },
  "message": "FAILED_WHILE_PROCESSING"
}

Sample Failure Response

{
  "result": false,
  "requestId": "9d4a874f-dd0e-4806-b91f-e1cf5405e371",
  "data": {}
}

Method

GET

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people/gsid

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only.
• people represents fetching a record from the Person, Company Person, and Relationship Person objects.
• gsid: It represents a unique GSID of a person record. This helps to fetch details of a record from the Person object and it’s company and relationship association details from the Company Person and Relationship Person objects respectively.

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

Successful API request will return HTTP status code 200 as response. Format of the success response is as shown below. If GSID passed in the endpoint URL matches with the person gsid of an existing record, system fetches values of each field in the Person, Company Person, and Relationship Person objects. If there is no value existing in a field, it results null in the success response. A sample success response is shown below:

{
    "result": true,
    "requestId": "b31b204c-6df8-444a-bfc7-d922a98bbebe",
    "data": {
        "email": "jsmith@abc.com",
        "createddate": "2018-06-05T12:03:16.417",
        "firstname": "John",
        "timezone": null,
        "dynamicresolutionkey": null,
        "modifieddate": "2018-06-05T12:03:16.417",
        "name": "John Smith",
        "lastname": "smith",
        "externalrecordid__gc": null,
        "masterrecordid": null,
        "middlename": null,
        "masteravatartypecode": null,
        "location": "United States",
        "gsid": "1P04AB23JMJA97MWFYJM8PQO1KQTAYV5MXJ1",
        "companies": [
            {
                "modifieddate": "2018-06-05T12:04:10.81",
                "company_id": {
                    "Id": "1P04QNK6ENCURXXDZW9WWWWWWWWWWTZCAAAA",
                    "name": "abc, Inc."
                },
                "gsid": "1C01KDEEJ1EH9CQP5LE79JLEPK9AH63AKWS1",
                "active": true,
                "isprimarycompany": null,
                "role": "1I0054U9FAKXZ0H26H4PSEVL0V2MP7H680C4",
                "manager": null,
                "createddate": "2018-06-05T12:04:10.81",
                "person_id": {
                    "Id": "1P04AB23JMJA97MWFYJM8PQO1KQTAYV5MXJ1",
                    "name": "John Smith"
                },
                "title": "Executive Sponsor",
                "relationships": [
                    {
                        "person_id": {
                            "Id": "1P04AB23JMJA97MWFYJM8PQO1KQTAYV5MXJ1",
                            "name": "John Smith"
                        },
                        "relationship_type_id": null,
                        "manager": null,
                        "company_id": {
                            "Id": "1P04QNK6ENCURXXDZW9WWWWWWWWWWTZCAAAA",
                            "name": "abc, Inc."
                        },
                        "createddate": "2018-06-05T12:06:29.023",
                        "isprimarycompany": null,
                        "role": null,
                        "relationship_id": {
                            "Id": "1I00V4ALRX6A6ZOEQ0FNJ3CXSRAVFFWJBBB1",
                            "name": "Asia Pacific"
                        },
                        "gsid": "1C03IGJ69L7HWHM6EZQ1WP8952BL2V8GKCY8",
                        "title": "Executive Sponsor",
                        "company_person_id": {
                            "Id": "1C01KDEEJ1EH9CQP5LE79JLEPK9AH63AKWS1"
                        },
                        "active": true,
                        "modifieddate": "2018-06-05T12:06:29.023"
                    }
                ]
            }
        ]
    }
}

In the above sample success response:

• data field has field:value pairs from the Person object
• companies field has field:value pairs from the Company Person object that also includes lookup fields company id and person id and the respective values from the Name fields.
• relationships field has field:value pairs from the Relationship Person object that also includes lookup fields company id, relationship id, person id, and the respective values from the Name fields.

Sample Failure Response

{
  "result": false,
  "errorCode": "GS_APIG_2401",
  "errorDesc": "Unauthorized",
  "requestId": "b0e79bb9-7404-4e5b-8d51-30344f95a396",
  "message": "Unauthorized"
}

Method

GET

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people?Email=jsmith@abc.com

In the above Endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only.
• people represents fetching a record from the Person, Company Person, and Relationship Person objects.
• gsid: It represents a unique GSID of a person record. This helps to fetch details of a record from the Person object and it’s company and relationship association details from the Company Person and Relationship Person objects respectively.

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

Successful API request will return HTTP status code 200 as response. Format of the success response is as shown below. Email mentioned in the endpoint URL is used as a unique identifier to identify a record in the Person object and fetches values from each field of this record in the Person, Company Person, and Relationship Person objects. If there is no value existing in a field, it results null in the success response. A sample success response is shown below:

{
    "result": true,
    "requestId": "b31b204c-6df8-444a-bfc7-d922a98bbebe",
    "data": {
        "email": "jsmith@abc.com",
        "createddate": "2018-06-05T12:03:16.417",
        "firstname": "John",
        "timezone": null,
        "dynamicresolutionkey": null,
        "modifieddate": "2018-06-05T12:03:16.417",
        "name": "John Smith",
        "lastname": "smith",
        "externalrecordid__gc": null,
        "masterrecordid": null,
        "middlename": null,
        "masteravatartypecode": null,
        "location": "United States",
        "gsid": "1P04AB23JMJA97MWFYJM8PQO1KQTAYV5MXJ1",
        "companies": [
            {
                "modifieddate": "2018-06-05T12:04:10.81",
                "company_id": {
                    "Id": "1P04QNK6ENCURXXDZW9WWWWWWWWWWTZCAAAA",
                    "name": "abc, Inc."
                },
                "gsid": "1C01KDEEJ1EH9CQP5LE79JLEPK9AH63AKWS1",
                "active": true,
                "isprimarycompany": null,
                "role": "1I0054U9FAKXZ0H26H4PSEVL0V2MP7H680C4",
                "manager": null,
                "createddate": "2018-06-05T12:04:10.81",
                "person_id": {
                    "Id": "1P04AB23JMJA97MWFYJM8PQO1KQTAYV5MXJ1",
                    "name": "John Smith"
                },
                "title": "Executive Sponsor",
                "relationships": [
                    {
                        "person_id": {
                            "Id": "1P04AB23JMJA97MWFYJM8PQO1KQTAYV5MXJ1",
                            "name": "John Smith"
                        },
                        "relationship_type_id": null,
                        "manager": null,
                        "company_id": {
                            "Id": "1P04QNK6ENCURXXDZW9WWWWWWWWWWTZCAAAA",
                            "name": "abc, Inc."
                        },
                        "createddate": "2018-06-05T12:06:29.023",
                        "isprimarycompany": null,
                        "role": null,
                        "relationship_id": {
                            "Id": "1I00V4ALRX6A6ZOEQ0FNJ3CXSRAVFFWJBBB1",
                            "name": "Asia Pacific"
                        },
                        "gsid": "1C03IGJ69L7HWHM6EZQ1WP8952BL2V8GKCY8",
                        "title": "Executive Sponsor",
                        "company_person_id": {
                            "Id": "1C01KDEEJ1EH9CQP5LE79JLEPK9AH63AKWS1"
                        },
                        "active": true,
                        "modifieddate": "2018-06-05T12:06:29.023"
                    }
                ]
            }
        ]
    }
}

In the above sample success response:

• data field has field:value pairs from the Person object
• companies field has field:value pairs from the Company Person object that also includes lookup fields company id, person id, and the respective values from the Name fields.
• relationships field has field:value pairs from the Relationship Person object that also includes lookup fields company id, relationship id, person id, and the respective values from the Name fields.

Sample Failure Response

{
   "result": true,
   "requestId": "ffce0c4e-ad8f-4704-8932-2f7e1149ba05",
   "data": {}
}

Method

DELETE

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only.
• people represents identifying record(s) to delete from the Person, Company Person, and Relationship Person objects.

Sample Request Body

You can pass GSIDs of the person records through the Request Body of this API. The respective person records, their corresponding records from the Company Person, Relationship Person, and person references in other Gainsight objects are deleted.

[
"1P04ARSY3839P6I6ECT3SZV21QW0RHARBU90",
"1P04ARSY3839P6I6ECN85PJ739P2QLZE2QKW",
"1P04ARSY3839P6I6ECKAX77N1RIABCUJ59GK"
]

Notes:

• You can pass a maximum of 5000 GSIDs per API call to delete them from the Gainsight Person object. 
• You can make a maximum of 100 Delete API calls per hour.

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

Sample response for the Delete API returns with deleteRequestId, status, and count. deleteRequestId represents the status id of the job submitted and helps you get the status of deleting person records using GET Delete status API. status represents the status of the job. You can see one of the following three status:

• INIT - initialisation, request accepted
• INPROGRESS - request in progress
• COMPLETED - request completed

count represents the number of records processed in a job.

{
    "result": true,
    "requestId": "b69ffec9-0893-400e-93ce-47824a888c52",
    "data": {
        "deleteRequestId": "b69ffec9-0893-400e-93ce-47824a888c52",
        "status": "INIT",
        "count": 0
    }
}

Sample Failure Response

{
  "result": false,
  "requestId": "b0f78892-24ef-4580-89b2-66e36ae1ba6c"
}

Method

GET

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/people/delete/status/{deleteRequestId}

In this endpoint URL:

• personapi.gainsightcloud.com is the domain through which you can connect to Gainsight. It is just for reference only.
• people represents identifying record(s) from the Person, Company Person, and Relationship Person objects to check the delete status.
• deleteRequestId helps you get the status of the request for deleting person records. For more information on the deleteRequestId, refer to the Delete API section.

Parameters

Following are the parameters for Person, Company Person, and Relationship Person objects.

Sample Success Response

Sample response for the GET Delete Status API returns with deleteRequestId, status, and count. deleteRequestId is the Id that you have passed in the Endpoint URL. status represents the status of the Delete API job. You can see one of the following three status:

• INIT - initialisation, request accepted
• INPROGRESS - request in progress
• COMPLETED - request completed

count represents the number of records processed in the Delete API job.

{
    "result": true,
    "requestId": "1b49a9e7-935a-47b2-b5ff-5f9c5dcd14b7",
    "data": {
        "deleteRequestId": "b69ffec9-0893-400e-93ce-47824a888c52",
        "status": "COMPLETED",
        "count": 1
    }
}

Sample Failure Response

{
  "result": false,
  "requestId": "b0f78892-24ef-4580-89b2-66e36ae1ba6c"
}

Method

PUT

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/external/bulk/ingestion/people

Sample Request Body

{
    "records": [
        {
            "Name": "John Smith",
            "FirstName": "John",
            "LastName": "Smith",
            "Email": "jsmith@gs.com",
            "companies": [
                {
                    "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                    "IsPrimaryCompany": "true",
                    "relationships": [
                        {
                            "Role": "Admin",
                            "IsPrimaryCompany": "true",
                            "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
                        },
                        {
                            "Role": "Admin",
                            "IsPrimaryCompany": "true",
                            "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
                        }
                    ]
                }
            ]
        },
        {
            "Name": "Steven Ferguson",
            "FirstName": "Steven",
            "LastName": "Ferguson",
            "Email": "sferguson@drivedata.com",
            "companies": [
                {
                    "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                    "IsPrimaryCompany": "true",
                    "relationships": [
                        {
                            "Role": "Executive Sponsor",
                            "IsPrimaryCompany": "true",
                            "Relationship_ID": "1P0589D9GZXBR11L31AIRD85YY0HG8XT0O37"
                        }
                    ]
                }, {
                    "Company_ID": "1P022A6Z2DWEK48YJME2XUU84B6OTTHEXDH6",
                    "IsPrimaryCompany": "true",
                    "relationships": [
                        {
                            "Role": "Executive Sponsor",
                            "IsPrimaryCompany": "true",
                            "Relationship_ID": "1P0589D9GZXBR11L31AIRD85YY0HG8XT0O37"
                        }
                    ]
                }
            ]
        }
    ]
}

Parameters

Sample Success Response

{
    "result": true,
    "requestId": "afef3724-2986-4b38-a3df-6f85fe9ecc9a",
    "data": {
        "successCount": 2,
        "totalCount": 2,
        "failureCount": 0,
        "partialSuccessCount": 0,
        "records": [
            {
                "record": {
                    "companies": [
                        {
                            "relationships": [
                                {
                                    "Role": "Admin",
                                    "Active": "true",
                                    "Gsid": "1C03LJDGQOSVO8PI22W60V6L2FMFPIHL0Z4T",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VV2GBXDD7Z9HAX28ZWP",
                                    "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                                    "Company_Person_ID": "1C01V3KWK4FX057IQ2KAHJ8ZERPSOLRPTZ8N",
                                    "rp_checkbox_default__gc": "true",
                                    "IsPrimaryCompany": "true",
                                    "Relationship_ID": "1P05X6HJ5J89CAI334N38ATFRMA8D6GUSQ0R"
                                }
                            ],
                            "Gsid": "1C01V3KWK4FX057IQ2KAHJ8ZERPSOLRPTZ8N",
                            "Company_ID": "1P0287ONRQ5E7UYP6VV2GBXDD7Z9HAX28ZWP",
                            "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "johnsmith@gs.com",
                    "Gsid": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                    "FirstName": "John",
                    "LastName": "Smith",
                    "Name": "John Smith",
                    "Location": "California, US"
                },
                "messageId": "1",
                "rowNumber": 1,
                "operationStatus": "SUCCESS"
            },
            {
                "record": {
                    "companies": [
                        {
                            "relationships": [
                                {
                                    "Role": "Executive Sponsor",
                                    "Active": "true",
                                    "Gsid": "1C03LJDGQOSVO8PI22T0JUF6EJEHZAFAB2TD",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VV2GBXDD7Z9HAX28ZWP",
                                    "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                                    "Company_Person_ID": "1C01V3KWK4FX057IQ2EUU0N7IPI7GKQEXY32",
                                    "rp_checkbox_default__gc": "true",
                                    "IsPrimaryCompany": "true",
                                    "Relationship_ID": "1P05X6HJ5J89CAI334N38ATFRMA8D6GUSQ0R"
                                }
                            ],
                            "Gsid": "1C01V3KWK4FX057IQ2EUU0N7IPI7GKQEXY32",
                            "Company_ID": "1P0287ONRQ5E7UYP6VV2GBXDD7Z9HAX28ZWP",
                            "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "stevenferguson@gs.com",
                    "Gsid": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                    "FirstName": "Steven",
                    "LastName": "Ferguson",
                    "Name": "Steven Ferguson",
                    "Location": "California, US"
                },
                "messageId": "2",
                "rowNumber": 2,
                "operationStatus": "SUCCESS"
            }
        ]
    }
}

Sample Partial Response

{
    "result": true,
    "requestId": "9edf5547-6d33-428f-9c01-3e6441e55889",
    "data": {
        "successCount": 0,
        "totalCount": 2,
        "failureCount": 0,
        "partialSuccessCount": 2,
        "records": [
            {
                "error": {
                    "rowNum": 1,
                    "details": [
                        {
                            "fieldName": "Company_ID,Person_ID,Relationship_ID",
                            "values": {
                                "Company_ID,Person_ID,Relationship_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Company_ID,Person_ID,Relationship_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        }
                    ]
                },
                "record": {
                    "companies": [
                        {
                            "relationships": [
                                {
                                    "Role": "Admin",
                                    "Gsid": "1C03LJDGQOSVO8PI225VAOGS7UFCW3K7U2EN",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                                    "Company_Person_ID": "1C01V3KWK4FX057IQ2XI81FUVKDK4TZI28QQ",
                                    "IsPrimaryCompany": "true",
                                    "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
                                },
                                {
                                    "Role": "Admin",
                                    "Active": "true",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                                    "Company_Person_ID": "1C01V3KWK4FX057IQ2XI81FUVKDK4TZI28QQ",
                                    "rp_checkbox_default__gc": "true",
                                    "IsPrimaryCompany": "true"
                                }
                            ],
                            "Gsid": "1C01V3KWK4FX057IQ2XI81FUVKDK4TZI28QQ",
                            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                            "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "johnsmith@gs.com",
                    "Gsid": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                    "FirstName": "John",
                    "LastName": "Smith",
                    "Name": "John Smith",
                    "Location": "California, US"
                },
                "messageId": "1",
                "rowNumber": 1,
                "operationStatus": "PARTIAL_SUCCESS"
            },
            {
                "error": {
                    "rowNum": 2,
                    "details": [
                        {
                            "fieldName": "Company_ID,Person_ID,Relationship_ID",
                            "values": {
                                "Company_ID,Person_ID,Relationship_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Company_ID,Person_ID,Relationship_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        }
                    ]
                },
                "record": {
                    "companies": [
                        {
                            "relationships": [],
                            "Gsid": "1C01V3KWK4FX057IQ2DUDXPKQ14JGMKRG0Y1",
                            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                            "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                            "IsPrimaryCompany": "true"
                        },
                        {
                            "relationships": [
                                {
                                    "Role": "Executive Sponsor",
                                    "Active": "true",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                                    "Company_Person_ID": "1C01V3KWK4FX057IQ2DUDXPKQ14JGMKRG0Y1",
                                    "rp_checkbox_default__gc": "true",
                                    "IsPrimaryCompany": "true"
                                }
                            ],
                            "Gsid": "1C01V3KWK4FX057IQ2DUDXPKQ14JGMKRG0Y1",
                            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                            "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "stevenferguson@gs.com",
                    "Gsid": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                    "FirstName": "Steven",
                    "LastName": "Ferguson",
                    "Name": "Steven Ferguson",
                    "Location": "California, US"
                },
                "messageId": "2",
                "rowNumber": 2,
                "operationStatus": "PARTIAL_SUCCESS"
            }
        ]
    }
}

Sample Failure Response

{
    "result": true,
    "requestId": "16a72fb5-da2f-4597-84f7-cfb6a72bcb75",
    "data": {
        "successCount": 0,
        "totalCount": 2,
        "failureCount": 2,
        "partialSuccessCount": 0,
        "records": [
            {
                "error": {
                    "rowNum": 1,
                    "details": [
                        {
                            "fieldName": "Email",
                            "values": {
                                "Email": "johnsmith@"
                            },
                            "errors": [
                                {
                                    "message": "Invalid email value",
                                    "code": "GSOBJ_VDTEMAIL1001"
                                }
                            ]
                        },
                        {
                            "fieldName": "Company_ID,Person_ID",
                            "values": {
                                "Company_ID,Person_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Person_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        },
                        {
                            "fieldName": "Company_ID,Person_ID,Relationship_ID",
                            "values": {
                                "Company_ID,Person_ID,Relationship_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Person_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        },
                        {
                            "fieldName": "Company_ID,Person_ID,Relationship_ID",
                            "values": {
                                "Company_ID,Person_ID,Relationship_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Person_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        }
                    ]
                },
                "record": {
                    "companies": [
                        {
                            "relationships": [
                                {
                                    "Role": "Admin",
                                    "Active": "true",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "IsPrimaryCompany": "true",
                                    "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
                                },
                                {
                                    "Role": "Admin",
                                    "Active": "true",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "IsPrimaryCompany": "true"
                                }
                            ],
                            "Active": "true",
                            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "johnsmith@",
                    "EmailOptOut": "false",
                    "FirstName": "John",
                    "LastName": "Smith",
                    "Name": "John Smith",
                    "Location": "California, US"
                },
                "messageId": "1",
                "rowNumber": 1,
                "operationStatus": "FAILURE"
            },
            {
                "error": {
                    "rowNum": 2,
                    "details": [
                        {
                            "fieldName": "Email",
                            "values": {
                                "Email": "stevenferguson@"
                            },
                            "errors": [
                                {
                                    "message": "Invalid email value",
                                    "code": "GSOBJ_VDTEMAIL1001"
                                }
                            ]
                        },
                        {
                            "fieldName": "Company_ID,Person_ID",
                            "values": {
                                "Company_ID,Person_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Person_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        },
                        {
                            "errors": [
                                {
                                    "message": "Row with the given resolution key already exists : {Company_ID=1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O, Person_ID=null}",
                                    "code": "GSOBJ_VCUSTOM1007"
                                }
                            ]
                        },
                        {
                            "fieldName": "Company_ID,Person_ID",
                            "values": {
                                "Company_ID,Person_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Person_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        },
                        {
                            "fieldName": "Company_ID,Person_ID,Relationship_ID",
                            "values": {
                                "Company_ID,Person_ID,Relationship_ID": {
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Resolution key value is null or empty : Person_ID",
                                    "code": "GSOBJ_VCUSTOM1012"
                                }
                            ]
                        }
                    ]
                },
                "record": {
                    "companies": [
                        {
                            "relationships": [],
                            "Active": "true",
                            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                            "IsPrimaryCompany": "true"
                        },
                        {
                            "relationships": [
                                {
                                    "Role": "Executive Sponsor",
                                    "Active": "true",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                                    "IsPrimaryCompany": "true"
                                }
                            ],
                            "Active": "true",
                            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "stevenferguson@",
                    "EmailOptOut": "false",
                    "FirstName": "Steven",
                    "LastName": "Ferguson",
                    "Name": "Steven Ferguson",
                    "Location": "California, US"
                },
                "messageId": "2",
                "rowNumber": 2,
                "operationStatus": "FAILURE"
            }
        ]
    }
}

Method

PUT

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/external/bulk/ingestion/people'

Sample Request Body

'{
    "lookups": {
        "relationships": {
            "Relationship_ID": {
                "objectName": "relationship",
                "onNoMatch": "ERROR",
                "multiMatchOption": "FIRSTMATCH",
                "fields": {
                    "RelationshipName": "Name"
                },
                "lookupField": "Gsid"
            }
        },
        "companies": {
            "Company_ID": {
                "objectName": "company",
                "onNoMatch": "ERROR",
                "multiMatchOption": "FIRSTMATCH",
                "fields": {
                    "CompanyName": "Name"
                },
                "lookupField": "Gsid"
            }
        }
    },
    "records": [
        {
            "companies": [
                {
                    "relationships": [
                        {
                            "RelationshipName": "Relationship1",
                            "IsPrimaryCompany": "True"
                        }
                    ],
                    "CompanyName": "Broadcom",
                    "IsPrimaryCompany": "True"
                }
            ],
            "Email": "janedoe@gmail.com",
            "FirstName": "Jane",
            "LastName": "Doe",
            "Name": "Jane Doe"
        }
    ]}'

Parameters

Sample Success Response

{
    "result": true,
    "requestId": "96aff241-c491-46bb-b06f-6c5b89593ee8",
    "data": {
        "successCount": 1,
        "totalCount": 1,
        "failureCount": 0,
        "partialSuccessCount": 0,
        "records": [
            {
                "record": {
                    "companies": [
                        {
                            "relationships": [
                                {
                                    "Active": "true",
                                    "Gsid": "1C030AY77URN4L94V7QHYXOVHLIIVPKRW0KG",
                                    "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                                    "Person_ID": "1P04BR1UNP9RWC9Y6WFR2D66U5MI3G1TW6PM",
                                    "Company_Person_ID": "1C01AXKEWJ9B3044W92TBFGSS2W4IVQK9OSX",
                                    "IsPrimaryCompany": "True",
                                    "CurrencyIsoCode": "USD",
                                    "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
                                }
                            ],
                            "Active": "true",
                            "Gsid": "1C01AXKEWJ9B3044W92TBFGSS2W4IVQK9OSX",
                            "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                            "Person_ID": "1P04BR1UNP9RWC9Y6WFR2D66U5MI3G1TW6PM",
                            "IsPrimaryCompany": "True",
                            "CurrencyIsoCode": "USD"
                        }
                    ],
                    "Email": "janedoe@gmail.com",
                    "EmailOptOut": "false",
                    "Gsid": "1P04BR1UNP9RWC9Y6WFR2D66U5MI3G1TW6PM",
                    "FirstName": "Jane",
                    "LastName": "Doe",
                    "CurrencyIsoCode": "USD",
                    "Name": "Jane Doe"
                },
                "messageId": "1",
                "rowNumber": 1,
                "operationStatus": "SUCCESS"
            }
        ]
    }
}

Sample Failure Response

{
    "result": true,
    "requestId": "be21edae-74d7-472b-b09b-e64307d83195",
    "data": {
        "successCount": 0,
        "totalCount": 2,
        "failureCount": 0,
        "partialSuccessCount": 2,
        "records": [
            {
                "error": {
                    "rowNum": 1,
                    "details": [
                        {
                            "fieldName": "Company_ID",
                            "values": {
                                "Company_ID": {
                                    "lookupData": {
                                        "Company_ID": "GSOBJ_RLS012"
                                    },
                                    "errorCode": "GSOBJ_RLS012"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Invalid gsid value",
                                    "code": "GSOBJ_VDTGSID1001"
                                }
                            ]
                        },
                        {
                            "fieldName": "Company_ID",
                            "values": {
                                "Company_ID": {
                                    "lookupData": {
                                        "Company_ID": "GSOBJ_RLS012"
                                    },
                                    "errorCode": "GSOBJ_RLS012"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Invalid gsid value",
                                    "code": "GSOBJ_VDTGSID1001"
                                }
                            ]
                        }
                    ]
                },
                "record": {
                    "companies": [
                        {
                            "relationships": [
                                {
                                    "Role": "Admin",
                                    "Active": "true",
                                    "Company_ID": {
                                        "lookupData": {
                                            "Company_ID": "GSOBJ_RLS012"
                                        },
                                        "errorCode": "GSOBJ_RLS012"
                                    },
                                    "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                                    "rp_checkbox_default__gc": "true",
                                    "IsPrimaryCompany": "true",
                                    "Relationship_ID": "1P05X6HJ5J89CAI334N38ATFRMA8D6GUSQ0R"
                                }
                            ],
                            "Active": "true",
                            "cp_checkbox_default__gc": "true",
                            "Company_ID": {
                                "lookupData": {
                                    "Company_ID": "GSOBJ_RLS012"
                                },
                                "errorCode": "GSOBJ_RLS012"
                            },
                            "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "johnsmith@gs.com",
                    "Gsid": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                    "FirstName": "John",
                    "LastName": "Smith",
                    "Name": "John Smith",
                    "Location": "California, US"
                },
                "messageId": "1",
                "rowNumber": 1,
                "operationStatus": "PARTIAL_SUCCESS"
            },
            {
                "error": {
                    "rowNum": 2,
                    "details": [
                        {
                            "fieldName": "Relationship_ID",
                            "values": {
                                "Relationship_ID": {
                                    "lookupData": {
                                        "Relationship_ID": "GSOBJ_RLS012"
                                    },
                                    "errorCode": "GSOBJ_RLS012"
                                }
                            },
                            "errors": [
                                {
                                    "message": "Invalid gsid value",
                                    "code": "GSOBJ_VDTGSID1001"
                                }
                            ]
                        }
                    ]
                },
                "record": {
                    "companies": [
                        {
                            "relationships": [
                                {
                                    "Role": "Executive Sponsor",
                                    "Active": "true",
                                    "Company_ID": "1P0287ONRQ5E7UYP6VV2GBXDD7Z9HAX28ZWP",
                                    "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                                    "Company_Person_ID": "1C01V3KWK4FX057IQ2EUU0N7IPI7GKQEXY32",
                                    "rp_checkbox_default__gc": "true",
                                    "IsPrimaryCompany": "true",
                                    "Relationship_ID": {
                                        "lookupData": {
                                            "Relationship_ID": "GSOBJ_RLS012"
                                        },
                                        "errorCode": "GSOBJ_RLS012"
                                    }
                                }
                            ],
                            "Gsid": "1C01V3KWK4FX057IQ2EUU0N7IPI7GKQEXY32",
                            "Company_ID": "1P0287ONRQ5E7UYP6VV2GBXDD7Z9HAX28ZWP",
                            "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                            "IsPrimaryCompany": "true"
                        }
                    ],
                    "Email": "stevenferguson@gs.com",
                    "Gsid": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                    "FirstName": "Steven",
                    "LastName": "Ferguson",
                    "Name": "Steven Ferguson",
                    "Location": "California, US"
                },
                "messageId": "2",
                "rowNumber": 2,
                "operationStatus": "PARTIAL_SUCCESS"
            }
        ]
    }
}

Method

POST

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/external/bulk/ingestion/async/people

Sample Request Body

{
"records"
:
[
{
"FirstName"
:
"FirstName0"
,
"LastName"
:
"LastName0"
,
"Email"
:
"testemail0@gs.com"
,
"Name"
:
"Name0"
}
,
{
"FirstName"
:
"FirstName1"
,
"LastName"
:
"LastName1"
,
"Email"
:
"testemail1@gs.com"
,
"Name"
:
"Name1"
}
,
{
"FirstName"
:
"FirstName2"
,
"LastName"
:
"LastName2"
,
"Email"
:
"testemail2@gs.com"
,
"Name"
:
"Name2"
}
,
{
"FirstName"
:
"FirstName3"
,
"LastName"
:
"LastName3"
,
"Email"
:
"testemail3@gs.com"
,
"Name"
:
"Name3"
}
]
}

Parameters

Sample Success Response 

{
"result": true,
"requestId": "4fea0e53-4ef6-43ef-89b8-203b07ddab9e",
"data": {
"jobId": "d69faa51-919c-40a1-b747-c64a5ae69c0e",
"statusUrl": "v1.0/external/bulk/ingestion/async/status/d69faa51-919c-40a1-b747-c64a5ae69c0e"
}
}

Method

GET

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/external/bulk/ingestion/async/status/<statusId>

Parameters

Sample Success Response

{
    "result": true,
    "requestId": "96a5941f-4130-4e80-a087-fddb6a9be7a5",
    "data": {
        "statusType": "COMPLETED",
        "response": {
            "status": "Completed",
            "successCount": 2,
            "failureCount": 0,
            "totalRecords": 2,
            "partialRecords": 0,
            "objectName": "person",
            "timeTaken": 0.795,
            "chunkDetails": [
                {
                    "chunkURL": "/external/bulk/ingestion/async/b00828df-d5a1-42a8-8b6e-1da09120e3b9/chunk/1/results"
                }
            ]
        }
    },
    "message": "COMPLETED"
}

Sample Failure Response

{
    "result": true,
    "requestId": "96a5941f-4130-4e80-a087-fddb6a9be7a5",
    "data": {
        "statusType": "COMPLETED",
        "response": {
            "status": "Completed",
            "successCount": 0,
            "failureCount": 2,
            "totalRecords": 2,
            "partialRecords": 0,
            "objectName": "person",
            "timeTaken": 0.795,
            "chunkDetails": [
                {
                    "chunkURL": "/external/bulk/ingestion/async/b00828df-d5a1-42a8-8b6e-1da09120e3b9/chunk/1/results"
                }
            ]
        }
    },
    "message": "COMPLETED"
}

Method

GET

Endpoint URL

https://personapi.gainsightcloud.com/v1/peoplemgmt/v1.0/external/bulk/ingestion/async/<statusId>/chunk/1/results

Parameters

Sample Success Response

{
  "successCount": 2,
  "totalCount": 2,
  "failureCount": 0,
  "partialSuccessCount": 0,
  "records": [
    {
      "record": {
        "companies": [
          {
            "relationships": [
              {
                "Role": "Admin",
                "Gsid": "1C03LJDGQOSVO8PI225VAOGS7UFCW3K7U2EN",
                "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                "Company_Person_ID": "1C01V3KWK4FX057IQ2XI81FUVKDK4TZI28QQ",
                "IsPrimaryCompany": "true",
                "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
              },
              {
                "Role": "Admin",
                "Gsid": "1C03LJDGQOSVO8PI22259VTZ3DB57NNP15DW",
                "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
                "Company_Person_ID": "1C01V3KWK4FX057IQ2XI81FUVKDK4TZI28QQ",
                "IsPrimaryCompany": "true",
                "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9H"
              }
            ],
            "Gsid": "1C01V3KWK4FX057IQ2XI81FUVKDK4TZI28QQ",
            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
            "Person_ID": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
            "IsPrimaryCompany": "true"
          }
        ],
        "Email": "johnsmith@gs.com",
        "Gsid": "1P04FFC950JNPDZ07X8XX5WGN88ZDUZVEY9F",
        "FirstName": "John",
        "LastName": "Smith",
        "Name": "John Smith",
        "Location": "California, US"
      },
      "messageId": "1",
      "rowNumber": 1,
      "operationStatus": "SUCCESS"
    },
    {
      "record": {
        "companies": [
          {
            "relationships": [],
            "Gsid": "1C01V3KWK4FX057IQ2DUDXPKQ14JGMKRG0Y1",
            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
            "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
            "IsPrimaryCompany": "true"
          },
          {
            "relationships": [
              {
                "Role": "Executive Sponsor",
                "Gsid": "1C03LJDGQOSVO8PI224BTI5JU8URLQCGDTRM",
                "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
                "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
                "Company_Person_ID": "1C01V3KWK4FX057IQ2DUDXPKQ14JGMKRG0Y1",
                "IsPrimaryCompany": "true",
                "Relationship_ID": "1P0589D9GZXBR11L31AIRD85YY0HG8XT0O37"
              }
            ],
            "Gsid": "1C01V3KWK4FX057IQ2DUDXPKQ14JGMKRG0Y1",
            "Company_ID": "1P0287ONRQ5E7UYP6VE9PPP3AW3GOA131A5O",
            "Person_ID": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
            "IsPrimaryCompany": "true"
          }
        ],
        "Email": "stevenferguson@gs.com",
        "Gsid": "1P04FFC950JNPDZ07XBTN9510MYF48IAUG7S",
        "FirstName": "Steven",
        "LastName": "Ferguson",
        "Name": "Steven Ferguson",
        "Location": "California, US"
      },
      "messageId": "2",
      "rowNumber": 2,
      "operationStatus": "SUCCESS"
    }
  ]
}

Sample Failure Response

{
  "successCount": 0,
  "totalCount": 2,
  "failureCount": 2,
  "partialSuccessCount": 0,
  "records": [
    {
      "error": {
        "rowNum": 1,
        "details": [
          {
            "fieldName": "Email,Location",
            "values": {
              "Email,Location": {
                "Email": "jsmith@gs.com"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Email,Location",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          },
          {
            "fieldName": "Company_ID,Person_ID",
            "values": {
              "Company_ID,Person_ID": {
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Person_ID",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          },
          {
            "fieldName": "Company_ID,Person_ID,Relationship_ID",
            "values": {
              "Company_ID,Person_ID,Relationship_ID": {
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Person_ID",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          },
          {
            "fieldName": "Company_ID,Person_ID,Relationship_ID",
            "values": {
              "Company_ID,Person_ID,Relationship_ID": {
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Person_ID",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          },
          {
            "fieldName": null,
            "values": null,
            "errors": [
              {
                "message": "Row with the given resolution key already exists : {Company_ID=1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52, Person_ID=null, Relationship_ID=1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G}",
                "code": "GSOBJ_VCUSTOM1007"
              }
            ]
          }
        ],
        "record": null
      },
      "record": {
        "fff__gc": "true",
        "companies": [
          {
            "multi__gc": null,
            "relationships": [
              {
                "Role": "Admin",
                "Active": "true",
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                "Person_ID": null,
                "Company_Person_ID": null,
                "rp_checkbox_default__gc": "true",
                "IsPrimaryCompany": "true",
                "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
              },
              {
                "Role": "Admin",
                "Active": "true",
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                "Person_ID": null,
                "Company_Person_ID": null,
                "rp_checkbox_default__gc": "true",
                "IsPrimaryCompany": "true",
                "Relationship_ID": "1P0589D9GZXBR11L3198SKRYVPPDQ0YXPL9G"
              }
            ],
            "Active": "true",
            "cp_checkbox_default__gc": "true",
            "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
            "Person_ID": null,
            "IsPrimaryCompany": "true"
          }
        ],
        "Email": "jsmith@gs.com",
        "p_checkbox_default__gc": "true",
        "EmailOptOut": "false",
        "FirstName": "John",
        "LastName": "Smith",
        "Name": "John Smith"
      },
      "messageId": "1",
      "rowNumber": 1,
      "operationStatus": "FAILURE",
      "operationType": null
    },
    {
      "error": {
        "rowNum": 2,
        "details": [
          {
            "fieldName": "Email,Location",
            "values": {
              "Email,Location": {
                "Email": "sferguson@gainsight.com"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Email,Location",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          },
          {
            "fieldName": "Company_ID,Person_ID",
            "values": {
              "Company_ID,Person_ID": {
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Person_ID",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          },
          {
            "fieldName": null,
            "values": null,
            "errors": [
              {
                "message": "Row with the given resolution key already exists : {Company_ID=1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52, Person_ID=null}",
                "code": "GSOBJ_VCUSTOM1007"
              }
            ]
          },
          {
            "fieldName": "Company_ID,Person_ID",
            "values": {
              "Company_ID,Person_ID": {
                "Company_ID": "1P022A6Z2DWEK48YJME2XUU84B6OTTHEXDH6"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Person_ID",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          },
          {
            "fieldName": "Company_ID,Person_ID,Relationship_ID",
            "values": {
              "Company_ID,Person_ID,Relationship_ID": {
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                "Relationship_ID": "1P0589D9GZXBR11L31AIRD85YY0HG8XT0O37"
              }
            },
            "errors": [
              {
                "message": "Resolution key value is null or empty : Person_ID",
                "code": "GSOBJ_VCUSTOM1012"
              }
            ]
          }
        ],
        "record": null
      },
      "record": {
        "fff__gc": "true",
        "companies": [
          {
            "multi__gc": null,
            "relationships": [],
            "Active": "true",
            "cp_checkbox_default__gc": "true",
            "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
            "Person_ID": null,
            "IsPrimaryCompany": "true"
          },
          {
            "multi__gc": null,
            "relationships": [
              {
                "Role": "Executive Sponsor",
                "Active": "true",
                "Company_ID": "1P022A6Z2DWEK48YJM70JL88EWWA8Y0MET52",
                "Person_ID": null,
                "Company_Person_ID": null,
                "rp_checkbox_default__gc": "true",
                "IsPrimaryCompany": "true",
                "Relationship_ID": "1P0589D9GZXBR11L31AIRD85YY0HG8XT0O37"
              }
            ],
            "Active": "true",
            "cp_checkbox_default__gc": "true",
            "Company_ID": "1P022A6Z2DWEK48YJME2XUU84B6OTTHEXDH6",
            "Person_ID": null,
            "IsPrimaryCompany": "true"
          }
        ],
        "Email": "sferguson@gainsight.com",
        "p_checkbox_default__gc": "true",
        "EmailOptOut": "false",
        "FirstName": "Steven",
        "LastName": "Ferguson",
        "Name": "Steven Ferguson"
      },
      "messageId": "2",
      "rowNumber": 2,
      "operationStatus": "FAILURE",
      "operationType": null
    }
  ],
  "outPutFilePath": null
}