Type-safe .NET clients for Azure connectors — call Office 365, SharePoint, Teams, Dataverse, and 1,000+ connectors directly from Azure Functions and other .NET apps.
Caution
Early Preview — Not for Production Use
This SDK is currently in early preview and is under active development. It is intended for evaluation, experimentation, and feedback purposes only.
- Do not use this SDK in production environments.
- Breaking changes should be expected across APIs, data models, and behavior in future releases.
- Features may be added, modified, or removed without prior notice.
We welcome feedback and contributions — please open an issue with questions, suggestions, or bug reports.
Azure provides a rich ecosystem of managed connectors that bridge your code to SaaS services, PaaS resources, and on-premises systems. Originally powering Azure Logic Apps and Power Automate, these connectors are now available as standalone, strongly-typed C# clients for any .NET application — no workflow service required.
- Type-safe operations — Generated async methods with full IntelliSense and XML documentation
- Built-in authentication — Managed identity and connection string token providers for API Hub
- Resilient HTTP — Configurable retry policies for transient failures
- 1,000+ connectors — Any Azure managed connector available via API Hub can be generated
Note: This is the .NET SDK. Python, Node.js, and Java SDKs are planned in collaboration with the Azure Functions team.
┌─────────────────────────────────────┐
│ Your Azure Function / App │
│ │
│ using Office365Client; │
│ await client.SendEmailAsync(...); │
└──────────────┬──────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ Generated Connector Clients │
│ (Office365Extensions.cs, etc.) │
│ │
│ • Typed async methods per action │
│ • Input/output models from Swagger │
│ • XML docs from connector metadata │
└──────────────┬──────────────────────┘
│ depends on
▼
┌─────────────────────────────────────┐
│ Azure Connectors .NET SDK │
│ Azure.Connectors.Sdk │
│ │
│ • Azure.Core TokenCredential auth │
│ • ConnectorHttpClient + retry │
│ • ConnectorJsonSerializer │
└─────────────────────────────────────┘
dotnet add package Azure.Connectors.Sdk --prereleaseUse the LogicAppsCompiler CLI to generate typed clients from connector Swagger definitions:
LogicAppsCompiler.exe ./generated unused --directClient --connectors=office365See GENERATION.md for detailed generation instructions.
Copy the generated *Extensions.cs files to your project.
using System;
using Azure.Connectors.Sdk;
using Azure.Connectors.Sdk.Office365;
using Azure.Identity;
// Get connection runtime URL from Azure Portal
var connectionRuntimeUrl = "https://...";
// Create client — defaults to ManagedIdentityCredential (system-assigned)
using var client = new Office365Client(connectionRuntimeUrl);
// For local development, pass AzureCliCredential explicitly
using var localClient = new Office365Client(
new Uri(connectionRuntimeUrl),
new AzureCliCredential());
// Or configure retry and diagnostics via ConnectorClientOptions
using var clientWithOptions = new Office365Client(
new Uri(connectionRuntimeUrl),
new AzureCliCredential(),
new ConnectorClientOptions());
// Call typed operations
await client.SendEmailAsync(new SendEmailInput
{
To = "recipient@example.com",
Subject = "Hello from SDK",
Body = "<p>Email body</p>"
});
var categories = await client.GetOutlookCategoryNamesAsync();| Component | Description |
|---|---|
ConnectorClientBase |
Abstract base class for all generated clients — provides authentication, retry, OTel tracing, JSON serialization, and SSRF-protected URL resolution |
ConnectorClientOptions |
Configuration for retry count, timeout, exponential backoff, and initial retry delay |
ConnectorException |
Unified exception for connector API failures with ConnectorName, Operation, StatusCode, and ResponseBody |
Authentication uses Azure.Core TokenCredential directly — any credential from Azure.Identity works:
| Credential | Use Case |
|---|---|
ManagedIdentityCredential |
Azure-hosted apps — system-assigned by default when no credential is specified |
AzureCliCredential |
Local development — pass explicitly (default no longer probes CLI) |
ClientSecretCredential |
Service principal authentication |
| Component | Description |
|---|---|
ConnectorHttpClient |
HTTP client with built-in authentication |
| Component | Description |
|---|---|
ConnectorJsonSerializer |
JSON serialization with connector conventions |
JsonConverters |
Custom converters for connector types |
- docs/concepts.md - Key concepts, terminology, and architecture
- GENERATION.md - How to generate connector code
- docs/connection-setup.md - Setting up connections for local testing
- ROADMAP.md - Connector generation progress and lessons learned
- Azure/Connectors-NET-Samples - Full working samples (Azure Functions, triggers, etc.)
- Connection Setup Skill - AI agent workflow for creating Connector Namespace connections, OAuth consent, access policies, and configuring app settings — all from within VS Code
| Connector | Status | Validated Operations |
|---|---|---|
| Azure Monitor Logs | 🔄 SDK Generated | QueryData, QueryDataV2, VisualizeQuery, VisualizeQueryV2 |
| IBM MQ | 🔄 SDK Generated | SendAsync, ReadAsync, ReadAllAsync, ReceiveAsync, ReceiveAllAsync, DeleteAsync, DeleteAllAsync |
| Office365 | ✅ Validated | SendEmail, GetOutlookCategoryNames, ExportEmail, CalendarPostItem |
| Office365 Users | ✅ Validated | MyProfile, UserProfile, Manager, DirectReports, SearchUser |
| OneDrive for Business | ✅ Validated | ListRootFolder, ListFolder, GetFileContentByPath, CreateFile, FindFilesByPath, CreateShareLink |
| SharePoint | ✅ Validated | GetAllTables, ListRootFolder, ListFolder, GetFileContentByPath, CreateFile |
| MS Graph Groups & Users | ✅ Validated | ListUsers, ListGroupsByDisplayNameSearch, GetGroupProperties |
| Teams | ✅ Validated | GetAllTeams, GetChannelsForGroup, PostMessageToConversation |
| SMTP | ✅ Validated | SendEmail |
| Azure Event Grid | ✅ E2E Validated | TopicTypesList, SubscriptionsList (trigger: CreateSubscription) |
| Excel Online | ✅ E2E Validated | GetTables (connectivity confirmed via sdk-test-gateway-prod) |
| Universal Print | ✅ E2E Validated | ListRecentShares (returned 0 shares via sdk-test-gateway-prod) |
| Microsoft Defender ATP | ✅ E2E Validated | GetAlerts (reached Defender API via sdk-test-gateway-prod; 403 = tenant permissions) |
| Yammer (Viva Engage) | ✅ E2E Validated | GetNetworks (returned 2 networks via sdk-test-gateway-prod) |
| Campfire | 🔄 SDK Generated | ListAccounts, ListRooms, CreateMessage (trigger: OnNewRoom) |
| ClickSend SMS | 🔄 SDK Generated | SmsSend, CreateList, GetContactLists (trigger: OnSmsInboundAutomation) |
| Cloudmersive Convert | 🔄 SDK Generated | ConvertDocumentAutodetectGetInfo, ConvertDocumentAutodetectToPdf |
| Etsy | 🔄 SDK Generated | Ping, PaymentLedgerEntries, PaymentGetEntryID |
| Formstack Forms | 🔄 SDK Generated | GetAvailableForms (trigger: OnFormstackFormSubmitted) |
| FreshService | 🔄 SDK Generated | AddNote, CreateTicket, UpdateTicket (trigger: OnTicketCreated) |
| Infusionsoft (Keap) | 🔄 SDK Generated | CreateTask, UpdateTask, ListTasks (trigger: OnNewTask) |
| Insightly | 🔄 SDK Generated | ListTasks, UpdateTask, AddTask (trigger: OnTaskAssignedToMe) |
| Pipedrive | 🔄 SDK Generated | ListDeals, GetDeal, UpdateDealStatus (trigger: OnTrigNewActivity) |
| Plivo | 🔄 SDK Generated | MakeCall, ListMessages, SendSMS |
| Plumsail | 🔄 SDK Generated | AddWatermarkToPdf, RegExpMatch, ParseCsv |
| Replicon | 🔄 SDK Generated | BulkGetProjectDetails3, CreateProjectOrApplyModifications |
| Rev.ai | 🔄 SDK Generated | TranscriptionGet, TranscriptionsGet, TranscriptionDelete |
| SigningHub | 🔄 SDK Generated | AttachmentGetAttachments, AttachmentDeleteAttachment |
| Zoho Sign | 🔄 SDK Generated | InvokeAPI, DownloadCompletionCertificate (trigger: OnZohoSignTriggers) |
| Docuware | 🔄 SDK Generated | GetOrganization, StoreToFileCabinet |
| Elfsquad Data | 🔄 SDK Generated | GetSchemas, GetEntities |
| Impexium | 🔄 SDK Generated | GetAbandonedCheckouts, ListAllExhibitors |
| Jedox OData Hub | 🔄 SDK Generated | Databases, GetCubes |
| Meeting Room Map | 🔄 SDK Generated | GetCategories, GetCustomLocations |
| Orderful | 🔄 SDK Generated | ListTransactions |
| PDF.co | 🔄 SDK Generated | HtmlToPdf, UrlToPdf, PdfFiller |
| Projectplace | 🔄 SDK Generated | ListBoards, CreateCard |
| Seismic Planner | 🔄 SDK Generated | GetComments, CreateComment |
| Starmind | 🔄 SDK Generated | FindExperts, FindQuestions |
| StarRez REST V1 | 🔄 SDK Generated | SelectEntry, CreateEntry, UpdateEntry |
| Tallyfy | 🔄 SDK Generated | GetUserOrganizations, EditTaskDeadline |
| TextRequest | 🔄 SDK Generated | GetMessagesByContactPhone, SendMessageByPhoneNumber |
| Ticketmaster | 🔄 SDK Generated | EventsGet, EventsGetDetails |
| Way We Do | 🔄 SDK Generated | GetAllChecklistInstances, CommentAdd |
| Azure Automation | 🔄 SDK Generated | CreateJob, GetStatusOfJob, GetJobOutput |
| Azure Data Factory | 🔄 SDK Generated | CreatePipelineRun, GetPipelineRun, CancelPipelineRun |
| Azure Digital Twins | 🔄 SDK Generated | AddTwin, GetTwinById, QueryTwins |
| Azure VM | 🔄 SDK Generated | VirtualMachineGet, VirtualMachineStart, VirtualMachineDeallocate |
| Key Vault | 🔄 SDK Generated | GetSecret, ListSecrets, EncryptData |
| Microsoft Bookings | 🔄 SDK Generated | ListBookingsBusinessUserAsAdmin |
| Office 365 Groups | 🔄 SDK Generated | ListGroups, AddMemberToGroup, CreateCalendarEvent |
| Office 365 Groups Mail | 🔄 SDK Generated | ListConversations, CreateConversation, ReplyToAThread |
| OneNote | 🔄 SDK Generated | GetNotebooks, CreatePageInSection, GetPageContent |
| Planner | 🔄 SDK Generated | ListMyTasks, CreateTask, UpdateTask |
| Power BI | 🔄 SDK Generated | ExecuteDatasetQuery, AddRows, RefreshDataset |
| Shifts | 🔄 SDK Generated | ListShifts, ListOpenShifts, GetSchedule |
| To Do | 🔄 SDK Generated | GetAllTodoLists, CreateToDo, GetToDo |
| Project | Description |
|---|---|
| Connector SDK Samples | Sample Azure Functions demonstrating SDK usage with Office 365, SharePoint, Teams, and more |
| Connector SDK LSP | Language Server Protocol server and VS Code extension for intelligent code assistance when developing with the SDK |
| Azure Functions Connector Extension | Azure Functions host and worker extensions for managed connectors |
Connectors should be regenerated periodically to incorporate Swagger updates:
LogicAppsCompiler.exe ./generated unused --directClient --connectors=office365,servicebus,teamsThe version is defined in eng/build/Version.props (VersionPrefix + VersionSuffix). Three ADO pipelines in azfunc/internal handle mirroring, building/signing, and publishing to nuget.org.
See the Releasing a New Version section in the copilot instructions for the full step-by-step procedure, pipeline IDs, version suffix behavior, and common pitfalls.
This project is licensed under the MIT License - see the LICENSE file for details.