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

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

Close
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
}