---
title: "Get custom field mapping capacity for an account"
method: GET
path: "/v3/ControlPlane/ConversationInsights/CustomFieldMappingsCapacity"
tags: ["TwilioInsightsConfig"]
---

# Get custom field mapping capacity for an account

`GET /v3/ControlPlane/ConversationInsights/CustomFieldMappingsCapacity`

## Request

- Base URL: `https://insights.twilio.com`
- URL: `https://insights.twilio.com/v3/ControlPlane/ConversationInsights/CustomFieldMappingsCapacity`
- Auth: HTTP basic

Returns the account's custom measure slot capacity — slots consumed and
remaining. Only the `measure` category is supported for now.

## Response `200`

Custom field mapping capacity for the account.

- CustomFieldCapacity: Custom field mapping slot capacity for the account, by category. Only the `measure` category is supported for now; the object is empty when custom measures are not available for the account.
  - `measure` CategoryCapacity: Slots consumed and remaining for the measure category. By default an account can register up to 3 custom measures, so `consumed + remaining` is the account's limit. Registering a new mapping when `remaining` is `0` returns `403`.
    - `consumed` integer, required: Number of custom field mapping slots already registered.
    - `remaining` integer, required: Number of custom field mapping slots still available.

## Other responses

- `401`: Unauthorized request
- `403`: Forbidden request
- `429`: Too Many requests (rate limit exceeded for request originating from public API)
- `500`: Internal server error

## Changes

- **2026-10-12** (v3) `68c9e65dfd52`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twilio/apis/insights-v3/changes/v3/ControlPlane/ConversationInsights/CustomFieldMappingsCapacity/get.md)

---

[API](https://skmtc.dev/twilio/apis/insights-v3.md) - [All operations](https://skmtc.dev/twilio/apis/insights-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/insights-v3/revisions/68c9e65dfd52?raw)