OrgsLinked Applications

addOrgOauthAppAccounts

POST
/api/v1/orgs/{org_id}/setting/{app_name}/link_accounts

Add a linked account for the specified OAuth application using the app-specific account configuration payload.

Authorization

Authorization<token>

Preferred authentication method for automation and integrations. Send the API token in the HTTP Authorization header.

Format: Authorization: Token {apitoken}

Notes:

  • An API token generated for a specific admin has the same privileges as that admin
  • An API token is automatically removed if it is not used for more than 90 days
  • SSO admins cannot generate admin API tokens. Use organization API tokens when scoped Org/Site privileges are needed.

In: header

Path Parameters

org_id*string
Formatuuid
app_name*string

OAuth application name

Value in

  • "crowdstrike"
  • "intune"
  • "jamf"
  • "mobicontrol"
  • "prisma"
  • "sentinelone"
  • "teams"
  • "vmware"
  • "zdx"
  • "zoom"

Request Body

application/json

Account configuration payload for adding a supported OAuth-linked application

OAuth linked Jamf apps account details

client_id*string

Customer account api client id. Required if app_name==crowdstrike

client_secret*string

Customer account api client secret

instance_url*string

Customer account Jamf instance URL

smartgroup_name*string

Smart group membership for determining compliance status

Response Body

curl -X POST "https://example.com/api/v1/orgs/000000ab-00ab-00ab-00ab-0000000000ab/setting/crowdstrike/link_accounts" \  -H "Content-Type: application/json" \  -d '{    "client_id": "string",    "client_secret": "string",    "instance_url": "junipertest.jamfcloud.com",    "smartgroup_name": "CompliantGroup1"  }'

{  "accounts": [    {      "account_id": "ae9dee49-69e7-4710-a114-5b827a777738",      "last_status": "success",      "last_sync": 1665465339000,      "linked_by": "Testname1",      "linked_timestamp": 1728275689.284758,      "name": "Test Company1 Ltd"    },    {      "account_id": "845a23bf-bed9-e43c-4c86-6fa474be7ae5",      "error": "Get token failed, please re-link crowdstrike",      "last_status": "failed",      "last_sync": 1234567890123,      "linked_by": "Testname2",      "linked_timestamp": 1728275689.284758,      "name": "Test Company2 Ltd"    }  ],  "linked": true}