Authentication

Details about authenticating your calls with Midlane

The Midlane API uses API keys for authentication. Visit our API settings page under your organization's settings to create and retrieve an API key that you can use in your requests. Any request that doesn't include an API key will return an error.

Remember that your API key is a secret! Do not share it with others or expose it in any client-side code (browsers, apps). Production requests must be routed through your own backend server where your API key can be securely loaded from an environment variable or key management service.

You need to be an Owner or an Admin to access this page.

How to make API calls

All API requests should include your API key in the Authorization HTTP header as follows:

Authorization: Bearer MIDLANE_API_KEY

An example curl request can be found below:

curl -X POST "https://app.midlane.com/api/public/candidates" \
-H "Authorization: Bearer $MIDLANE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "email": "[email protected]",
  "mobilePhoneNumber": "[phone]",
  "firstName": "Thomas",
  "lastName": "Mueller"
}'