Skip to content
LiveNew tools this week
Submit
AIMarketly
Create Workforce Integration logo

Create Workforce Integration

Create a new workforce integration using the Microsoft Teams API.

naftiko/microsoft-teams-sandbox0installs0stars

SKILL.md

Full skill instructions

Create Workforce Integration

Create a new workforce integration using the Microsoft Teams API.

API Details

  • API Name: Microsoft Teams API
  • OpenAPI Ref: ../​../​openapi/​microsoft-teams-openapi.yaml
  • Endpoint: POST /​teamwork/​workforceIntegrations
  • Operation ID: createWorkforceIntegration
  • Tag: WorkforceIntegrations

Sandbox

  • Base URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0
  • Full URL: http://localhost:8080/rest/microsoft-teams-api/1.0.0/teamwork/workforceIntegrations

Required Headers

  • Content-Type: application/​json
  • Authorization: Bearer {access_token}

OAuth Scopes

  • WorkforceIntegration.ReadWrite.All

Parameters

Request Body

NameTypeRequiredDescription
displayNamestringYesThe display name of the workforce integration.
apiVersionintegerNoThe API version of the workforce integration.
isActivebooleanNoWhether the workforce integration is active.
urlstringYesThe URL of the workforce integration endpoint.
supportedEntitiesstringNoComma-separated list of supported entities (e.g., shift, timeCard, timeOff).
encryptionobjectNoEncryption configuration for the integration.

Example Request

curl -X POST \
  "http://localhost:8080/rest/microsoft-teams-api/1.0.0/teamwork/workforceIntegrations" \
  -H "Content-Type: application/​json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "displayName": "Kronos Integration",
    "apiVersion": 1,
    "isActive": true,
    "url": "https://kronos.example.com/api/v1/teams",
    "supportedEntities": "shift,timeCard,timeOff"
  }'

Example Response

{
  "id": "wfi-001",
  "displayName": "Kronos Integration",
  "apiVersion": 1,
  "isActive": true,
  "url": "https://kronos.example.com/api/v1/teams",
  "supportedEntities": "shift,timeCard,timeOff"
}

Instructions

  1. Obtain a valid access token with the WorkforceIntegration.ReadWrite.All scope.
  2. Construct the request body with the workforce integration details including display name, URL, and supported entities.
  3. Send the POST request to the workforceIntegrations endpoint.
  4. A 201 Created response indicates the workforce integration was successfully created.
  5. The response body contains the created workforce integration object with its assigned id.