dataverse-sdk

dataverse-sdk

This skill provides guidance on using the PowerPlatform Dataverse Client SDK for Python. Use when users ask about "Dataverse SDK", "Dataverse Python", "DataverseClient", "Dataverse authentication", "Dataverse CRUD operations", "create Dataverse records", "query Dataverse", "Dataverse connection", or need help with the Microsoft Dataverse Python SDK.

Quick Start

Install the SDK:

pip install PowerPlatform-Dataverse-Client azure-identity

Basic setup:

from azure.identity import InteractiveBrowserCredential
from PowerPlatform.Dataverse.client import DataverseClient

credential = InteractiveBrowserCredential()
client = DataverseClient("https://yourorg.crm.dynamics.com", credential)

Authentication Methods

Interactive Browser (Development)

from azure.identity import InteractiveBrowserCredential
credential = InteractiveBrowserCredential()

Opens a browser window for user to sign in. Best for development and testing.

Device Code (Headless Systems)

from azure.identity import DeviceCodeCredential
credential = DeviceCodeCredential()

Displays a code to enter on a separate device. Use for servers without browsers.

Client Secret (Production/Automation)

from azure.identity import ClientSecretCredential
credential = ClientSecretCredential(
    tenant_id="your-tenant-id",
    client_id="your-app-id",
    client_secret="your-secret"
)

Service principal authentication for automated processes. Requires Azure app registration.

CRUD Operations

Create Records

# Single record
account_ids = client.create("account", {"name": "Contoso Ltd"})
account_id = account_ids[0]

# Multiple records (bulk)
payloads = [
    {"name": "Company A"},
    {"name": "Company B"},
]
ids = client.create("account", payloads)

Read Records

# Single record by ID
account = client.get("account", account_id)

# Query with filters
pages = client.get(
    "account",
    select=["name", "telephone1"],
    filter="statecode eq 0",
    top=100
)
for page in pages:
    for record in page:
        print(record["name"])