{"id":27490333,"url":"https://github.com/microsoft/powerplatformconnectors","last_synced_at":"2025-05-14T11:09:07.810Z","repository":{"id":37450961,"uuid":"161588836","full_name":"microsoft/PowerPlatformConnectors","owner":"microsoft","description":"This is a repository for Microsoft Power Automate, Power Apps, and Azure Logic Apps connectors","archived":false,"fork":false,"pushed_at":"2025-04-15T13:55:18.000Z","size":27992,"stargazers_count":1053,"open_issues_count":253,"forks_count":1311,"subscribers_count":57,"default_branch":"dev","last_synced_at":"2025-04-15T14:45:44.288Z","etag":null,"topics":["connector","hacktoberfest","logicapps","microsoft","power-platform","powerapps","powerautomate"],"latest_commit_sha":null,"homepage":"https://aka.ms/connectors","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2018-12-13T05:33:24.000Z","updated_at":"2025-04-15T13:55:24.000Z","dependencies_parsed_at":"2023-09-27T18:00:59.701Z","dependency_job_id":"88ae691b-6f7a-4611-910b-2db9e043a2d7","html_url":"https://github.com/microsoft/PowerPlatformConnectors","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FPowerPlatformConnectors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FPowerPlatformConnectors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FPowerPlatformConnectors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2FPowerPlatformConnectors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/PowerPlatformConnectors/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249275777,"owners_count":21242284,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["connector","hacktoberfest","logicapps","microsoft","power-platform","powerapps","powerautomate"],"created_at":"2025-04-16T20:54:08.925Z","updated_at":"2025-04-16T20:54:09.642Z","avatar_url":"https://github.com/microsoft.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"Microsoft Power Platform Connectors\n\nWelcome to the Microsoft Power Platform Connectors open source repository. This repository contains custom connectors, certified connectors, and related tools to facilitate connector development for Azure Logic Apps, Microsoft Power Apps, and Microsoft Power Automate.\n\n## Custom Connectors\n\nThe ```custom-connectors``` folder contains fully functional connector samples which can be deployed to the Power Platform for extension and use. If you are looking to publish a connector to the Power Platform, please explore Certified Connectors and Independent Publisher Connectors.\n\n## Certified Connectors\n\nThe ```certified-connectors``` folder contains certified connectors which are built by partners who own the end service of their connector. These connectors are deployed and available out-of-box within the Power Platform for use.\nOne requirement of our [connector certification program](https://docs.microsoft.com/connectors/custom-connectors/submit-certification) is that new certified connectors be open sourced for community contributions.\nThe ```certified-connectors``` folder is managed by the Microsoft Connector Certification Team to ensure that within the ```master``` branch, the connector version is identical to that deployed in the Power Platform.\nThe ```dev``` branch is maintained by the connector owner and the Microsoft Connector Certification Team to allow community development of the connector prior to certification and deployment of a version.\n\n## Independent Publisher Connectors\n\nThe ```independent-publisher-connectors``` folder contains connectors that are submitted by publishers (MVPs, developers, and companies) that do not own the underlying service behind their connector. These connectors are deployed and available out-of-box within the Power Platform as premium connectors. Anyone can submit a new connector to this folder, add functionality to connectors in this folder, and resolve issues related to the connectors in this folder. The folder is managed by the Independent Publisher Connector Community, which includes Independent Publishers and Project Coordinators. The master branch is maintained by the Microsoft Connector Certification Team, who ensures that the connector version is identical to that deployed in the Power Platform. The dev branch is maintained by the connector maintainer(s) and the Microsoft Connector Certification Team to allow community development of the connector prior to certification and deployment of a version. Click here to view the [Independent Publisher Connector Manifesto](https://github.com/microsoft/PowerPlatformConnectors/wiki/Independent-Publisher-Connector-Group-%22Manifesto%22).\n\n## Contributing\n\nThis project welcomes contributions and suggestions. Most contributions require you to agree to a\nContributor License Agreement (CLA), which declares that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit https://cla.microsoft.com.\n\n### Files to Include\n\nPlease submit the following files: An Open API 2.0 swagger definition, an API properties file, and a README.md.\n\n### API Definition (Swagger) File\n\nThe API definition, also known as the swagger, describes the API for the custom connector using the OpenAPI specification.\n\nFor further details, see the [apiDefinition.swagger.json](schemas/apiDefinition.swagger.schema.json) JSON schema.\n\n### API Properties File\n\nThe API properties file contains some properties for the custom connector. These properties are not part of the API definition. It contains information such as the brand color, authentication information, etc. A typical API properties file looks like the following:\n\n```json\n{\n  \"properties\": {\n    \"capabilities\": [],\n    \"connectionParameters\": {\n      \"api_key\": {\n        \"type\": \"securestring\",\n        \"uiDefinition\": {\n          \"constraints\": {\n            \"clearText\": false,\n            \"required\": \"true\",\n            \"tabIndex\": 2\n          },\n          \"description\": \"The KEY for this API\",\n          \"displayName\": \"KEY\",\n          \"tooltip\": \"Provide your KEY\"\n        }\n      }\n    },\n    \"iconBrandColor\": \"#007EE6\",\n    \"policyTemplateInstances\": [\n      {\n        \"title\": \"MyPolicy\",\n        \"templateId\": \"setqueryparameter\",\n        \"parameters\": {\n            \"x-ms-apimTemplateParameter.name\": \"queryParameterName\",\n            \"x-ms-apimTemplateParameter.value\": \"queryParameterValue\",\n            \"x-ms-apimTemplateParameter.existsAction\": \"override\"\n        }\n      }\n    ]    \n  }\n}\n```\n\nMore information on each of the properties are given below:\n\n* `properties`: The container for the information.\n\n* `connectionParameters`: Defines the connection parameter for the service.\n\n* `iconBrandColor`: The icon brand color in HTML hex code for the custom connector. Independent Publisher connectors must set the color to `\"#da3b01\"`.\n\n* `capabilities`: Describes the capabilities for the connector, e.g. cloud only, on-prem gateway etc.\n\n* `policyTemplateInstances`: An optional list of policy template instances and values used in the custom connector.\n\nFor further details, see the [apiProperties.json](schemas/paconn-apiProperties.schema.json) JSON schema.\n\n### README.md\n\nREADME.md file for your connector includes a description for your connector, any prerequisite a developer or contributor may need to build your connector. It includes instructions on how to use your connector and api, how to get credentials, supported operations, known issues and limitations, etc. This file is meant to be a standalone guide for deploying and using your connector by other users and developers. A good example is the [Azure Key Vault](custom-connectors/AzureKeyVault/Readme.md) custom connector.\nA readme.md template for [Certified Connectors](templates/certified-connectors/readme.md) and [Independent Publisher Connectors](templates/Independent%20Publisher/readme.md) is also included for your reference. If you are submitting an Independent Publisher connector that requires OAuth, please make sure to explain how to create the OAuth app. The Microsoft Certification Team will use those instructions to create the app, so please make sure they are detailed and accurate. \n\n### Creating a Fork\n\nTo contribute to this open source repository, start by creating a fork on this repository. To do so, select the \"fork\" button in the upper right corner, and create your own copy of the repository. Next, sync your fork with the remote repository and clone your forked repository to your local machine.\n\n```git clone https://github.com/YOUR-USERNAME/PowerPlatformConnectors.git```\n\nCheck your remote URL.\n\n```git remote -v```\n\n```\n\u003e origin  https://github.com/YOUR_USERNAME/PowerPlatformConnectors.git (fetch)\n\u003e origin  https://github.com/YOUR_USERNAME/PowerPlatformConnectors.git (push)\n```\n\nAdd an upstream repository for your clone.\n\n```git remote add upstream https://github.com/microsoft/PowerPlatformConnectors.git```\n\nVerify the upstream links.\n\n```git remote -v```\n\n```\n\u003e origin    https://github.com/YOUR_USERNAME/PowerPlatformConnectors.git (fetch)\n\u003e origin    https://github.com/YOUR_USERNAME/PowerPlatformConnectors.git (push)\n\u003e upstream  https://github.com/microsoft/PowerPlatformConnectors.git (fetch)\n\u003e upstream  https://github.com/microsoft/PowerPlatformConnectors.git (push)\n```\n\nTo keep your fork up to date with this repository's updates, run these commands:\n\n```git fetch upstream```\n\n```git checkout master```\n\n```git merge upstream/master```\n\nYou are now ready to develop your connector in your own branch.\n\n### Submitting to the Open Source Repository\n\nContributions to the open source repository are made through pull requests.\nPrior to submitting a pull request, ensure that 1) you have thoroughly tested the connector 2) you have provided response schemas unless the responses are dynamic, and 3) that your pull request does not contain any sensitive or specific information, for example client ids or client secrets.\nAny sensitive values can be replaced with fake or dummy values for the purposes of submission as long as it is clearly indicated.\nAlso, ensure that the readme.md of the connector is updated with the latest information, or created for new connector submissions.\nAn example of a clear, structured, readme.md can be found for the [Azure Key Vault](custom-connectors/AzureKeyVault/Readme.md) connector.\nA readme.md template for [Certified Connectors](templates/certified-connectors/readme.md) and [Independent Publisher Connectors](templates/Independent%20Publisher/readme.md) is also included for your reference.\nPut the `readme.md` in the same directory as the other connector files.\nAdd tags indicating which connector type you are submitting. Connector type name should match the folder name you are submitting to: custom-connector, certified-connector, or independent-publisher-connector.\n\n#### Certified Connectors\n\nFor new connectors which will be submitted for certification, create a directory under the ```certified-connectors``` directory, place the connector files in the sub-folder, and submit a pull request to the ```dev``` branch. Ensure that a clear, structured, readme.md is included.\n\nAdd a tag by selecting the labels option to \"certified-connector\"\n\nUpdates to certified connectors must first be made through a pull request to the ```dev``` branch for review by the connector owner.\n\nOnce a pull request has been merged to the ```dev``` branch, the connector owner can submit the connector for certification through the Connector certification tab in [ISV Studio](https://isvstudio.powerapps.com). Once certified, the Microsoft Certification team will handle merging the updates from ```dev``` to ```master```.\n\nUpdates to an existing custom connector can be made through a simple pull request to the ```dev``` branch to update the custom connector files.\n\n#### Independent Publisher Connectors\n\nFollow the same instructions as above on submitting for certification, create a directory under the \"independent-publisher-connectors\" directory and place the connector files in the sub-folder.\nThe `\"iconBrandColor\":` in the API properties file must be set to `\"#da3b01\"`.\nSet your pull request title to \"Connector Name (Independent Publisher).\"\nPaste in screenshots from the Test operations section and 3 unique operations (actions/triggers) working within a Flow. This can be in one flow or part of multiple flows. For each one of those flows, I have pasted in screenshots of the Flow succeeding.\nAdd a tag by selecting the labels option to \"independent-publisher-connector.\"\nIf the connector uses OAuth, I have provided detailed steps on how to create an app in the readme.md.\n\n#### Custom Connectors\n\nFollow the same instructions on submitting for certification, create a directory under the custom-connectors directory and place the connector files in the sub-folder. Add a tag by selecting the labels option to \"custom-connector\".\n\n### Tooling and Validation\n\n#### CLA\n\nWhen a pull request is submitted, a CLA-bot will automatically determine whether you need to provide\na CLA and annotate the PR appropriately. Simply follow the instructions\nprovided by the bot to ensure your pull request can be properly reviewed.\nYou will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n#### Swagger Validation\n\nA submitted pull request will also be validated against our Swagger Validator tool, which checks the connector files to ensure it is a proper Swagger file and adheres to our connector requirements and guidelines. Any errors or warnings will be added to the PR for both the submitter and the reviewer to understand. We do not accept pull requests with outstanding unresolved Swagger Validator issues.\n\n#### Breaking Change Detector\n\nAnother validation which runs on a submitted pull request is the breaking changes validator. This is to catch any inadvertent, non-backwards-compatible (i.e. breaking) changes which may break a current user experience, for example, deleting a published operation. The Breaking Change Detector compares the previous version of the Swagger with the new submission and raises awareness of any breaking change. The submitter and reviewer must both acknowledge any breaking changes submitted and ensure that no end users are inadvertently negatively affected. \n\n## Legal Notices\n\nMicrosoft and any contributors grant you a license to the Microsoft documentation and other content\nin this repository under the [Creative Commons Attribution 4.0 International Public License](https://creativecommons.org/licenses/by/4.0/legalcode),\nsee the [LICENSE](LICENSE) file, and grant you a license to any code in the repository under the [MIT License](https://opensource.org/licenses/MIT), see the\n[LICENSE-CODE](LICENSE-CODE) file.\n\nMicrosoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation\nmay be either trademarks or registered trademarks of Microsoft in the United States and/or other countries.\nThe licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks.\nMicrosoft's general trademark guidelines can be found at http://go.microsoft.com/fwlink/?LinkID=254653.\n\nPrivacy information can be found at https://privacy.microsoft.com/en-us/\n\nMicrosoft and any contributors reserve all others rights, whether under their respective copyrights, patents,\nor trademarks, whether by implication, estoppel or otherwise.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fpowerplatformconnectors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fpowerplatformconnectors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fpowerplatformconnectors/lists"}