Create custom event

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://px-apidocs.gainsight.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "gainsight-px-rest-api MCP server": {
    "url": "https://px-apidocs.gainsight.com/mcp"
  }
}

POST /v1/events/custom

Creates custom event with the given data

application/json

Body Required

Custom event data

eventId string
identifyId string Required
propertyKey string Required
date integer(int64)
eventType string
sessionId string
userType string Required

Values are LEAD, USER, VISITOR, or EMPTY_USER_TYPE.
accountId string
globalContext object
eventName string Required
attributes object
url string
referrer string
remoteHost string

Responses

201 */*

Create custom events
Hide response attributes Show response attributes object
- body object
- statusCode string
  
  Values are 100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 307, 308, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 419, 420, 421, 422, 423, 424, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 509, 510, or 511.
- statusCodeValue integer(int32)
400

Bad request
401

Unauthorized or bad API Key
429

Rate limit exceeded
500

Internal error

POST /v1/events/custom

curl \
 --request POST 'https://api.aptrinsic.com/v1/events/custom' \
 --header "Content-Type: application/json" \
 --data '{
  "eventId": "string",
  "identifyId": "string",
  "propertyKey": "string",
  "date": 42,
  "eventType": "string",
  "sessionId": "string",
  "userType": "LEAD",
  "accountId": "string",
  "globalContext": {},
  "eventName": "string",
  "attributes": {},
  "url": "string",
  "referrer": "string",
  "remoteHost": "string"
}'

Request examples

{
  "eventId": "string",
  "identifyId": "string",
  "propertyKey": "string",
  "date": 42,
  "eventType": "string",
  "sessionId": "string",
  "userType": "LEAD",
  "accountId": "string",
  "globalContext": {},
  "eventName": "string",
  "attributes": {},
  "url": "string",
  "referrer": "string",
  "remoteHost": "string"
}

Response examples (201)

{
  "body": {},
  "statusCode": "100",
  "statusCodeValue": 42
}