TwilioInsightsConfig

List custom measure field mappings for an account

Changed on

Returns the custom field mappings registered for the account, one page at a time. Use pageSize to limit the number of mappings returned, and pass meta.nextToken from a response as pageToken to fetch the next page. On the last page, meta.nextToken is null.

get/v3/ControlPlane/ConversationInsights/CustomFieldMappings

Request

  • Base URL
    https://insights.twilio.com
  • URL
    https://insights.twilio.com/v3/ControlPlane/ConversationInsights/CustomFieldMappings
  • Auth
    HTTP basic

Query parameters

pageSizeinteger

The maximum number of resources to return

pageTokenstring

Token for pagination

Response

A page of custom field mappings registered for the account.

Example response

{
  "items": [
    {
      "id": "convinsights_mapping_01m31967b7em08vh1pqgbam3mj",
      "name": "LeadScore",
      "description": "Lead quality score derived from sentiment analysis",
      "entityMetadata": {
        "intelligenceOperator": {
          "operatorId": "intelligence_operator_01kcgy1ew0e9x8re6jq542zt8b",
          "operatorName": "Sentiment Analysis",
          "field": "leadScore"
        }
      },
      "createdAt": "2026-08-13T14:30:00Z",
      "updatedAt": "2026-09-30T10:00:00Z"
    }
  ],
  "meta": {
    "key": "items",
    "pageSize": 20,
    "previousToken": "eyJwYWdlIjowLCJxdWVyeSI6ImJvb2tzIn0=",
    "nextToken": "eyJwYWdlIjoyLCJxdWVyeSI6ImJvb2tzIn0="
  }
}

Changes

    • breaking

      removed the required property from the response with the status

    • info

      api operation id FetchCustomFieldMappings removed and replaced with ListCustomFieldMappings

    • info

      added the new optional query request parameter pageSize

    • info

      added the new optional query request parameter pageToken

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      endpoint added