addOrgMobiControleAppAuthorization

POST https://{{host}}/api/v1/orgs/:org_id/setting/mobicontrol/link_accounts

Body Parameters

NameTypeDescription
org_idstringRequired, Organization ID
instance_urlstringRequired, Customer account MobiControl instance URL
client_idstringRequired, Customer account API client ID
client_secretstringRequired, Customer account API client Secret
usernamestringRequired, Customer account username
passwordstringRequired, Customer account password

Response Definitions

NameTypeDescription
linkedbooleanapplication linked status, is mist portal enabled for Jamf
accountslistList of linked Jamf account details

Request Body

{"instance_url"=>"Customer account MobiControl instance URL", "client_id"=>"Customer account API client ID", "client_secret"=>"Customer account API client Secret", "username"=>"Customer account username", "password"=>"Customer account password"}

RESPONSES

status: OK

"{\n    \"linked\": true, \n    \"accounts\": [\n            {\n                \"account_id\": \"7f80cd00-40b1-49e5-b2cb-9386d89af0d6\", \n                \"instance_url\": \"https://a0020372.mobicontrol.cloud\", \n                \"client_id\": \"3e408b13255844149f2830e8609fe8f3\",\n                \"last_sync\": 1665465339000, \n                \"last_status\": \"success\", \n                \"linked_by\": \"User1\", \n                \"linked_timestamp\": 1702284364, \n                \"name\": \"Company1 Ltd.\", \n            }, \n\n            {\n                \"account_id\": \"80364a28-7ccc-4746-b110-ecf3dfd3a359\", \n                \"instance_url\": \"https://a0032314.mobicontrol.cloud\", // Linked MobiControl Instance URL\n                \"client_id\": \"e81cfb1980454b4bb6109c74136ca528\", //Linked MobiControl Client Id\n                \"last_sync\": 1234567890123, // Last data pull timestamp, background jobs that pull MobiControl account data\n                \"last_status\": \"failed\", // Is the last data pull for MobiControl account is successful or not\n                \"linked_by\": \"User2\", // First name of the user who linked the MobiControl account\n                \"linked_timestamp\": 1702284364, \n                \"name\": \"Company2 Ltd.\", // Name of the company whose MobiControl account mist has subscribed to\n                \"error\" : \"Get token failed, please re-link MobiControl account\" // This error is provided when the MobiControl account fails to fetch token/data\n            }\n        ]\n}"