API Reference

API Keys

# Using Basic Auth
curl https://api.middesk.com/v1/businesses \
  -u mk_live_50e41b726c05c15cbf8bc13f:

# Using Bearer Auth
curl https://api.middesk.com/v1/businesses \
  -H 'Authorization: Bearer mk_live_50e41b726c05c15cbf8bc13f'

Authentication to the API using API keys is generally performed via HTTP Basic Auth. Provide the API key as the basic auth username value. No password is required.

Bearer authentication is supported as well, in which case you can pass a header value as Authorization: Bearer mk_live_4eC39HqLyjWDarjtT1zdp7dc.

All API requests should be made over HTTPS.

Finding Your API Keys

When your Middesk account is created, a set of API keys is automatically provisioned for your account. You can find you API keys by taking the following steps:

  1. Log in to your Middesk dashboard account

  2. Click your button in the upper-right-hand corner with either the first letter of your name or your profile picture. This will open up a dropdown

203
  1. Select "Settings" on the dropdown. This will navigate you to the Middesk settings page
197
  1. Select "Credentials" on the left-hand-side of the page. This will navigate you to the Middesk credentials page.
162

Your sandbox API key will be listed on the credentials page as the "Test API Key" and your production API key will be listed as the "Live API Key."

1209