Syskit Point
Schedule a DemoStart a Free TrialContact UsProduct Site
  • Syskit Point
  • Releases
    • Syskit Point Cloud
      • May 13, 2025
      • May 06, 2025
      • April 29, 2025
      • April 22, 2025
      • April 08, 2025
      • April 01, 2025
      • March 25, 2025
      • March 18, 2025
      • March 11, 2025
      • March 04, 2025
      • February 25, 2025
      • February 18, 2025
      • February 11, 2025
      • February 06, 2025
      • January 28, 2025
      • January 22, 2025
      • January 14, 2025
      • January 02, 2025
      • December 17, 2024
      • December 10, 2024
      • December 03, 2024
      • November 26, 2024
      • November 19, 2024
      • November 05, 2024
      • October 29, 2024
      • October 22, 2024
      • October 15, 2024
      • October 08, 2024
      • October 01, 2024
      • September 24, 2024
      • September 18, 2024
      • September 02, 2024
      • August 26, 2024
      • August 20, 2024
      • August 12, 2024
      • August 06, 2024
      • July 29, 2024
      • July 23, 2024
      • July 02, 2024
      • June 18, 2024
      • June 04, 2024
      • May 21, 2024
      • May 09, 2024
      • April 23, 2024
      • April 9, 2024
      • March 26, 2024
      • March 12, 2024
      • February 22, 2024
      • February 06, 2024
      • January 19, 2024
      • January 18, 2024
      • December 19, 2023
      • November 30, 2023
      • November 15, 2023
      • November 2, 2023
      • November 2, 2023 - Announcement
      • October 17, 2023
      • October 3, 2023
      • September 21, 2023
      • September 14, 2023
      • September 7, 2023
      • August 23, 2023
      • August 9, 2023
      • July 26, 2023
      • July 12, 2023
      • May 16, 2023
    • Syskit Point Data Center
      • Syskit Point 2025.2
        • Syskit Point 2025.2.90
        • Syskit Point 2025.2.86
        • Syskit Point 2025.2.82
        • Syskit Point 2025.2.78
      • Syskit Point 2024.6
        • Syskit Point 2024.6.73
        • Syskit Point 2024.6.71
        • Syskit Point 2024.6.70
      • Syskit Point 2024.5
        • Syskit Point 2024.5.67
        • Syskit Point 2024.5.65
      • Syskit Point 2024.4
        • Syskit Point 2024.4.60
        • Syskit Point 2024.4.54
        • Syskit Point 2024.4.52
      • Syskit Point 2024.3
        • Syskit Point 2024.3.48
      • Syskit Point 2024.2
        • Syskit Point 2024.2.45
      • Syskit Point 2024.1
        • Syskit Point 2024.1.43
        • Syskit Point 2024.1.41
      • Syskit Point 2023.5
        • Syskit Point 2023.5.39
      • Syskit Point 2023.4
        • Syskit Point 2023.4.1
        • Syskit Point 2023.4.0
      • Syskit Point 2023.3
      • Syskit Point 2023.2
      • Syskit Point 2023.1
        • Syskit Point 2023.1.3
        • Syskit Point 2023.1.2
        • Syskit Point 2023.1.1
        • Syskit Point 2023.1.0
      • Syskit Point 2022.5
        • Syskit Point 2022.5.1
        • Syskit Point 2022.5.0
      • Syskit Point 2022.4
        • Syskit Point 2022.4.1
        • Syskit Point 2022.4.0
      • Syskit Point 2022.3
        • Syskit Point 2022.3.1
        • Syskit Point 2022.3.0
      • Syskit Point 2022.2
        • Syskit Point 2022.2.3
        • Syskit Point 2022.2.2
        • Syskit Point 2022.2.1
        • Syskit Point 2022.2.0
      • Syskit Point 2021.12
      • Syskit Point 2021.11
      • Syskit Point 2021.10
      • Syskit Point 20
      • Syskit Point 19
        • Syskit Point 19.0.2
        • Syskit Point 19.0.1
        • Syskit Point 19.0.0
  • Requirements
    • Permission Requirements
    • Change Log
  • Set Up Point Cloud
    • Overview
    • Free Trial
    • Free Trial Limits
    • Manage Syskit Point Subscriptions
  • Set Up Point Data Center
    • Deployment
      • Overview
      • System Requirements
      • Deploy Syskit Point
      • Connect to Microsoft 365 Tenant
      • Set Up Custom Domain and SSL Certificate
      • Upgrade Syskit Point
      • Azure Networking
    • Activation
      • Activate Syskit Point
      • Free Trial Data Center
  • Licensing & Activation
    • Licensed Users Count
    • Activation Privacy Statement
  • Get to Know Syskit Point
    • The Syskit Point Starter Kit
    • Navigate Through Syskit Point
    • Collect Microsoft 365 Data
  • Microsoft 365 Inventory
    • Microsoft 365 Inventory Overview
    • Explore Your Microsoft 365 Dashboard
    • Sites
    • Microsoft Teams & Groups
    • Users
    • Copilot Readiness
  • Configuration
    • Syskit Point Configuration Guide
    • Assign and Manage Access to Syskit Point
    • Enable Microsoft Teams Activity Tracking
    • Configure Storage Management in Syskit Point
    • Set Up E-Mail
    • Connect Service Account
    • Customize Audit Logs Collection
    • Upgrade SQL to Managed Identity Authentication
    • Enable Power Platform Data Collection
    • Enable Power BI Data Collection
    • Ignore Service Account Activity Tracking
    • Customize License Reports
    • Customize E-Mails
    • Report Data Limits
    • Turn On Auditing
    • Exclude Users from Receiving Governance Tasks
    • Customize Dashboard
    • Customize Syskit Point Appearance
    • Configure Your Environment for Storage Management
    • Save Custom Views
    • Audit for Syskit Point Settings
    • Manage Connection
  • Reporting
    • Overview
    • External Sharing Reports
    • Access Reports
    • Audit Reports
    • Cleanup & Health Reports
    • Licenses Reports
    • Analytics Reports
    • Sensitivity Labels Reports
    • Power Platform Reports
    • Power BI Reports
  • Storage Management
    • Storage Management Overview
    • Free Up Storage
    • Storage Reports
    • Limit Storage Usage
    • Storage Versioning Limits
  • Governance & Automation
    • Syskit Point Tasks
    • Access Review
      • Enable Automated Access Review
      • Create and Apply Access Review Policies
      • Modify Access Review Options
      • Monitor Access Review in Syskit Point
      • Manually Request Access Review in Syskit Point
    • Lifecycle Management
      • Lifecycle Management - Deprecated
      • Identify Inactive Workspaces
      • Enable Lifecycle Management Automation
      • Monitor Lifecycle Management Tasks in Syskit Point
      • Run Lifecycle Management Actions in Syskit Point
    • Policies
      • Set Up Policies
      • Rules
      • Blocked Users with Assigned Licenses
      • Inactive Guest Users
      • Inactive Workspaces
      • Minimum Number of Owners
      • Maximum Number of Owners
      • Orphaned Workspaces
      • Orphaned Users
      • Tenant Storage Limit
      • Workspaces with Too Many Members
      • Workspaces with Shadow Users
      • Private Workspaces Shared with Everyone
      • Workspaces Without a Sensitivity Label
      • Apply Policies
      • Upgrade to Rules
    • Security and Compliance Checks
      • Security and Compliance Checks
      • Inactive Workspaces
      • Orphaned Workspaces
      • Inactive Guest Users
      • Blocked Users with Assigned Licenses
      • Workspaces with Not Enough Owners
      • Orphaned Users
      • Workspaces with Too Many Owners
      • Tenant Storage Limit
      • Workspaces with Too Many Members
      • Workspaces with Shadow Users
      • Private Workspaces Shared with Everyone
      • Workspaces Without a Sensitivity Label
    • Provisioning
      • Set Up Provisioning
      • Enable or Disable Provisioning
      • Register Yammer App
      • Enable Sensitivity Labels
      • Restrict Microsoft 365 Groups Creation
      • Templates
      • Content & Structure
      • Configure Provisioning Failure Notifications
      • Approval Processes
      • Approve/Reject Requests
      • Manage Requests
      • Hide Workspace Name
    • Access Requests
      • Set Up Access Requests
      • Create Access Requests
      • Apply Access Requests
      • Approval Process
    • Metadata
      • Manage Custom Metadata
      • Request Metadata Review
      • Monitor Metadata Review
    • Sensitivity Review
      • Request Sensitivity Review
      • Monitor Sensitivity Review
    • Privacy Review
      • Request Privacy Review
      • Monitor Privacy Review
    • Syskit Point Teams App
    • Schedule Reports
    • Configure Alerts
    • Manage Sensitivity Labels
  • Access Management
    • Track Microsoft 365 External Users and Their Activities
    • Check Access for Specific Microsoft 365 User
    • Copy User Permissions
    • Delete and Restore Users
    • View Permission Changes in Microsoft 365
    • Supervise Microsoft Teams Private Channels
    • Manage Private Channels Access
    • Complete Power Platform Actions
  • Integrations
    • Overview
    • Syskit Point API
    • Webhooks
    • Examples
      • Webhooks
      • ServiceNow
      • Jira
  • FAQ
    • Security
    • Security Self Assessment Questionnaire
    • Storage Management
    • Free Trial
    • Licensing
    • Activation
    • Purchasing and Discounts
    • Customer Terms
    • Privacy and Compliance
    • Partner Program
    • Site Storage Limits
    • Orphaned Users
    • Inactive Users Detection
    • Provisioning - Content & Structure
  • Troubleshooting
    • Export Diagnostic Logs
    • Setup Diagnostic Logs Export
    • Analytics and Usage Report Issues
  • Explore Syskit Point for Site Owners/Collaborators
    • Syskit Point for Collaborators
    • Resolve Governance Tasks
      • My Tasks
      • Complete Access Review Tasks
      • Complete Metadata Review Tasks
      • Complete Privacy Review Tasks
      • Complete Sensitivity Review Tasks
      • Resolve Inactive Workspaces Tasks
      • Resolve Lifecycle Management Tasks
      • Resolve Inactive Guest Users Tasks
      • Resolve Minimum Number of Owners Tasks
      • Resolve Maximum Number of Owners Tasks
      • Resolve Orphaned Workspaces Tasks
      • Resolve Tenant Storage Limit Task
    • Manage Access
      • Manage External Sharing
      • Manage Users
    • Manage Workspaces
      • Request New Workspace
      • Request Workspace Access
      • Manage Workspaces
      • Manage Custom Metadata
    • Reporting
      • Syskit Icons Glossary
      • Inventory Reports
      • Schedule Reports
      • Alerts
      • Cleanup & Health Reports
      • External Sharing Reports
      • Access Reports
Powered by GitBook
On this page
  • Prerequisites
  • Microsoft Entra Setup
  • Permissions
  • WebHooksEndpoint
  • Users
  • SharePointSites
  • Groups
  • Provisioning
  • Options
  • AsyncRequests
  • Fetch the access_token
  • Example Request
  • Syskit Point API Documentation

Was this helpful?

  1. Integrations

Syskit Point API

This article explains how to get started with Syskit Point API.

PreviousOverviewNextWebhooks

Last updated 3 months ago

Was this helpful?

Please note! To utilize Provisioning via Syskit Point API, the Governance plan or above is required. See the for more details.

In this article, you can find steps to create your first request to your Syskit Point web app. You will need to perform the following steps:

  • Create and set an app registration in Microsoft Entra ID

  • Fetch the access_token

  • Send your first request to Syskit Point

Prerequisites

To complete the steps described in this article, make sure to have the following:

  • Syskit Point Instance - running Point Cloud or Data Center instance

  • Microsoft Entra/Azure Active Directory Access - you should be able to create an App registration in Microsoft Entra/Azure Active Directory

Microsoft Entra Setup

To enable Postman to get access tokens for API requests, you must create and configure an additional App registration in Microsoft Entra.

First, create the New app registration:

  • Navigate to (1)

  • Create a new registration by clicking the New registration button (2)

    • Provide a Name (3) - e.g., API Demo

    • Click Register (4)

Second, create a new client secret:

  • Navigate to Manage > Certificates & Secrets (1)

  • Click the New client secret option (2) - a sidebar opens where you can:

    • Enter client secret description (3)

    • Define expiration (4)

    • Click Add (5) to finish

Please note! Once the new client secret is created, immediately copy (1) and save the client secret value to the side.

Afterward, configure API permissions:

  • Navigate to Manage > API Permissions (1)

  • Click Add a permission option (2) - a sidebar opens where you should:

    • Select the APIs my organization uses tab; search and find Syskit Point API (3) and click to select - sidebar shows new information

    • Select the displayed permission (4)

      • We strongly encourage applying the principle of least privilege and provide the minimum level of permissions required to accommodate your integration requirements

    • Click Add permissions (5)

  • Click the Grant admin consent option (6) - confirmation dialog opens: Click Yes to confirm

Lastly, collect the following data and save to side with the client secret value stored before:

  • Application (client) ID

  • Directory (tenant) ID

  • Syskit Point API Application (client) ID - find the Syskit Point API app registration and copy the Application (client) ID from the Overview screen

Permissions

There are 4 permissions providing access to different Syskit Point endpoints:

  • SharePoint.Read.All

  • Point.AsyncRequests

  • Point.Provisioning

  • Point.Admin

Find permission required for specific endpoints/requests below.

WebHooksEndpoint

Required permission: Point.Admin

Request
Description

POST /v1.0/webhook/endpoints

Add an endpoint to which Syskit Point will post webhooks events. Specify a valid URL and list of event types to be notified about.

Users

Required permission: Point.AsyncRequests

Request
Description

POST /v1.0/users/access/generate

Initiate a request to receive information about SharePoint access for a given user.

SharePointSites

Required permission: SharePoint.Read.All

Request
Description

POST /v1.0/sites/permissions/generate

Initiate a request to receive information about permissions on a list of SharePoint sites.

GET /v1.0/sites

Get a list of all SharePoint sites Syskit Point is tracking.

Groups

Required permission: SharePoint.Read.All OR Point.AsyncRequests

Request
Description

POST /v1.0/groups/memberships

Initiate a request to receive information about group memberships for provided group IDs.

GET /v1.0/groups

Get the groupID and other relevant information for all groups tracked by Syskit Point.

GET /v1.0/groups/{groupName}

Get the groupID and other relevant information for a single group based on the provided group name.

GET /v1.0/groups?groupType={groupType}

Get the groupID and other relevant information for all groups that match the provided groupType. The following group types are available: DistributionList, UnifiedGroup, SecurityGroup, MailEnabledSecurityGroup

Provisioning

Required permission: Point.Provisioning

Request
Description

POST /v1.0/provision/teams

Provision Microsoft Teams based on a provisioning template.

POST /v1.0/provision/groups

Provision Microsoft 365 Groups based on a provisioning template.

POST /v1.0/provision/sites

Provision SharePoint sites based on a provisioning template.

POST /v1.0/provision/yammer

Provision Yammer Communities based on a provisioning template.

GET /v1.0/provision/templates

Get all provisioning templates in Syskit Point.

GET /v1.0/provision/requests/{requestId}

Get status for a provisioning request with specified request ID.

Please note! To automatically approve provisioning requests created via API requests, use provisioning templates with the Approval Process property set to 'Automatically Approve'.

Options

Required permission: Point.Admin

Request
Description

GET /v1.0/options

Get options available for use with Syskit Point API and Webhooks.

AsyncRequests

Required permission: SharePoint.Read.All OR Point.AsyncRequests

Request
Description

GET /v1.0/requests/{requestId}/status

Get the status of a request with the specified request ID.

GET /v1.0/requests/{requestId}/result

Get the result of a request with the specified request ID.

Fetch the access_token

Here, you can find an example of how to fetch the access_token using Postman.

Create a new POST request:

POST https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token

Replace the <tenant-id> in your request with your Directory (tenant) ID saved in the previous step.

Body Include the following parameters in the request body

Name
Type
Description
Example Value

client_id

string

Application (client) ID of the created app registration

0a1948f2-b37b-4c38-8430-2c3ad19ba71c

client_secret

string

Client secret created in the previous step

Ma8QhffkTUrO53J8XpKQWl-rnsw.4l~_AG-arJ

grant_type

string

Enter the string 'client_credentials'

client_credentials

scope

string

Combine the Application (client) ID of Syskit Point API app registration and string '/.default'

ee22be9d-e792-45c2-8955-deb8fd565aa5/.default

Click Send and wait for the response.

The provided example is shown in the image below:

Copy the access_token property from the response to use in further requests to your Syskit Point web app.

Example Request

Using Postman, let's create the first request to your Syskit Point web app.

Create a new GET request:

GET {{pointWebAppUrl}}/v1.0/sites

Under Authorization > Type, select Bearer Token and paste the access_token retrieved in the previous step.

Click Send and wait for the response.

The provided example is shown in the image below:

Syskit Point API Documentation

To find more information about the Syskit Point API, navigate to the provided Swagger documentation. You can find it on the following URL:

  • <YourSyskitPointWebAppURL/swagger>

  • For example, contoso.syskit365demo.com/swagger

pricing page
Microsoft Entra > Identity > Applications > App registrations
Find more details about available permissions in the Permissions section
Microsoft Entra - New registration
Microsoft Entra - Register
New client secret
Copy client secret value
Request API permissions
Grant Admin Consent
Get Access Token
GET Request to Syskit Point