Authorizing an Account

A user must authorize your account for you to access their information on Middesk. To do this you'll create a link to Middesk where they can approve access. The link's url looks like this:

https://accounts.middesk.com/oauth/authorize?response_type=code&client_id={CLIENT_ID}&redirect_uri={CLIENT_REDIRECT_URI}&scope={REQUESTED_SCOPE}

Replace CLIENT_ID and CLIENT_REDIRECT_URI with your actual OAuth client_id and corresponding redirect_uri located on the credentials page in the Middesk developer settings dashboard. Replace REQUESTED_SCOPE with one of read_only or read_write.
On Middesk, the user will be prompted to log in to their Middesk account and authorize integration with your platform.

The link contains the parameters outlined below:

Request Parameters

ParameterDescription
client_idThe unique identifier provided to your OAuth client. Located on the credentials page.
redirect_uriThe URL that a user is redirected to upon authorizing the account
response_typeThe only option is code
scopeEither read_only or read_write. Defaults to read_only if not specified.