CustomerInsightsManagementClient

Name: CustomerInsightsManagementClient API
Brand: Customer Insights Management
Availability: InStock

★ Only Publicly Available OpenAPI DocumentCRMContact Managementoauth266 EndpointsREST

For Agents

Provision Azure Customer Insights hubs and configure the connectors, profiles, KPIs, predictions, relationships, and views inside them through 66 management-plane operations.

Connect the CustomerInsightsManagementClient to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CustomerInsightsManagementClient, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with CustomerInsightsManagementClient API.

Create and delete Customer Insights hubs and configure their authorization policies and roles

Define connectors to ingest customer data from Azure Blob Storage, SQL, Salesforce, and other sources, plus their connector mappings

Manage profile, interaction, and relationship type definitions inside a hub

Configure links between source entities and target profiles or interactions

GET STARTED

Start building with CustomerInsightsManagementClient API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for CustomerInsightsManagementClient, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for CustomerInsightsManagementClient, keeping it validated and agent-ready. The Azure Customer Insights management API exposes 66 operations across 41 paths to provision and configure Customer Insights hubs and the data entities inside them. Hubs hold the customer profile graph; under each hub you can manage authorization policies, connectors, links, profiles, interactions, kpis, predictions, relationships, roles, and views. Use it to programmatically stand up a Customer Insights tenant, wire data sources into it, and define the segments and KPIs that downstream marketing tools consume.

Use Cases

Patterns agents use CustomerInsightsManagementClient API for, with concrete tasks.

★ Provision a Customer Insights Hub

Stand up a new Customer Insights hub through the Hubs CreateOrUpdate endpoint, specifying the SKU, hub billing info, and tenant features. Once the hub is provisioned the tenant ID is used as the prefix for all subsequent resource paths inside the hub. Hubs typically take a few minutes to provision and are ready for connector configuration immediately.

Create a Customer Insights hub named 'retail-prod' in resource group 'rg-ci' with SKU 'B0' and tenant features enabled, then return the hub tenant ID

Wire Data Sources into the Customer Graph

Connect external data sources by creating a Connector resource (Azure Blob, SQL, Salesforce, ExchangeOnline, Outbound) and one or more ConnectorMappings that map source columns to target Profile or Interaction entities. The mapping defines incremental load rules, error handling, and refresh schedule. Once active the connector populates the hub's customer graph on the configured cadence.

Create a Salesforce connector on hub 'retail-prod' with credentials secret reference, then add a connector mapping that loads Account into a Profile of type 'Customer' on a daily refresh

Operate KPIs and Predictions

Define KPIs (count, sum, average, min, max measures over a profile or interaction with optional dimensions) and Predictions (out-of-the-box churn or custom). The API exposes lifecycle operations to create, retrain, and delete each. KPI threshold alerts fire when the measured value crosses a defined limit, allowing automation to trigger downstream campaigns.

Create a KPI named 'orders-last-30d' on hub 'retail-prod' that counts Interaction:Order grouped by ProfileId and runs daily, then list KPIs to confirm creation

Multi-Tenant Hub Management

List and manage Customer Insights hubs across an entire subscription for platform teams running multi-brand or multi-region deployments. The Hubs ListBySubscription and ListByResourceGroup endpoints return every hub the caller has access to, and per-hub Get returns the full configuration. Pair with role-assignment endpoints to control who can edit each hub.

List all Customer Insights hubs in subscription /subscriptions/{id} and report their SKU, location, and provisioningState

AI Agent CDP Configuration

An AI agent supporting marketing operations can configure Customer Insights through Jentic. The agent searches by intent ('add salesforce connector to customer insights'), Jentic returns the matching Connectors_CreateOrUpdate operation with its schema, and the agent executes the call with managed Azure credentials. Re-runs of the same flow keep connectors and KPIs aligned with the marketing playbook without manual portal use.

Search Jentic for 'create a customer insights connector', load the Connectors_CreateOrUpdate schema, and execute it with the user-supplied connector name, type, and credentials reference

Key Endpoints

66 endpoints — jentic publishes the only available openapi specification for customerinsightsmanagementclient, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/subscriptions/{subscriptionId}/providers/Microsoft.CustomerInsights/hubs

List all Customer Insights hubs in a subscription

DELETE

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}

Delete a Customer Insights hub

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/authorizationPolicies

List authorization policies on a hub

POST

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/authorizationPolicies/{authorizationPolicyName}/regeneratePrimaryKey

Regenerate the primary key on a hub authorization policy

GET

/providers/Microsoft.CustomerInsights/operations

List Microsoft.CustomerInsights provider operations

GET

/subscriptions/{subscriptionId}/providers/Microsoft.CustomerInsights/hubs

List all Customer Insights hubs in a subscription

DELETE

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}

Delete a Customer Insights hub

GET

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/authorizationPolicies

List authorization policies on a hub

POST

/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CustomerInsights/hubs/{hubName}/authorizationPolicies/{authorizationPolicyName}/regeneratePrimaryKey

Regenerate the primary key on a hub authorization policy

GET

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Azure service principal credentials are encrypted in the Jentic vault. Agents receive scoped ARM bearer tokens at execution time; the client secret never enters the agent context.

Intent-based discovery

Agents search by intent ('create a customer insights hub' or 'add a salesforce connector') and Jentic returns the matching operation from the 66 available, avoiding the need to load the full management surface.

Time to first call

Direct ARM integration: 2-3 days for AAD app registration, MSAL handling, long-running-operation polling, and per-resource schema marshalling. Through Jentic: under 1 hour.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Data Factory Management

Build the upstream ETL pipelines that feed Customer Insights connectors with cleaned data.

Use Data Factory when an agent needs to land or transform raw source data before Customer Insights ingests it via a connector.

Alternative

Cosmos DB

Store custom-built customer profile graphs directly in a multi-model database instead of a managed CDP.

Choose Cosmos DB when teams want to build their own profile graph and KPIs; choose Customer Insights for a managed unified profile graph.

Complementary

Azure Monitor Management

Configure metric and log alerts for Customer Insights hubs and their connector runs.

Use when an agent needs to alert on connector failure or hub health alongside Customer Insights configuration.

FAQs

Specific to using CustomerInsightsManagementClient API through Jentic.

Why is there no official OpenAPI spec for CustomerInsightsManagementClient?

Microsoft Azure does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call CustomerInsightsManagementClient via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Customer Insights management API use?

It uses Azure Active Directory OAuth 2.0 against https://management.azure.com/ with the user_impersonation scope. The caller needs at least Contributor on the resource group containing the hub. Jentic stores the service principal credentials encrypted and issues bearer tokens to the agent at execution time.

Can I create connectors and connector mappings with this API?

Yes. Connectors_CreateOrUpdate creates a connector under a hub (Salesforce, Azure Blob, SQL, Exchange Online, Outbound), and ConnectorMappings_CreateOrUpdate defines how source columns map to Profile or Interaction entities including refresh schedule and error handling.

What are the rate limits for the Customer Insights management API?

Azure Resource Manager applies subscription-level read and write throttling (around 1,200 requests per hour). Long-running operations such as hub creation or prediction training return 202 Accepted with a Location header that you poll for completion.

How do I add a connector through Jentic?

Run pip install jentic and search for 'create customer insights connector'. Jentic returns the Connectors_CreateOrUpdate operation; load its schema and execute it with the subscriptionId, resourceGroupName, hubName, connectorName, and a body specifying the connector type and connectorProperties.

Does this API expose customer profile data directly?

No. This is the management-plane API — it defines profile types, connectors, KPIs, and predictions, but does not return individual customer records. Profile data is queried through the Customer Insights data API on the hub's runtime endpoint.