---
title: "Authorize a candidate"
method: POST
path: "/candidates/authorization"
tags: ["Candidates"]
---

# Authorize a candidate

`POST /candidates/authorization`

Check if an email and password match an existing candidate. Returns the Candidate if authorized, or a 404 if not.
You can use this endpoint to allow a user to "log in" and edit their contact data.

## Request body

- object
  - `email` string
  - `password` string

## Response `200`

OK

- object
  - `id` number
  - `first_name` string
  - `middle_name` string
  - `last_name` string
  - `title` string
  - `emails` object
    - `primary` string
    - `secondary` string
  - `address` object
    - `street` string
    - `city` string
    - `state` string
    - `postal_code` string
  - `country_code` string
  - `social_media_urls` unknown[]
    - unknown
  - `website` string
  - `best_time_to_call` string
  - `current_employer` string
  - `date_available` string
  - `current_pay` string
  - `desired_pay` string
  - `is_willing_to_relocate` boolean
  - `key_skills` string
  - `notes` string
  - `source` string
  - `is_hot` boolean
  - `is_active` boolean
  - `is_registered` boolean
  - `contact_id` number
  - `owner_id` number
  - `entered_by_id` number
  - `date_created` string
  - `date_modified` string
  - `_links` object
  - `_embedded` object

---

[API](https://skmtc.net/catsone/apis/cats-api-v3.md) · [All operations](https://skmtc.net/catsone/apis/cats-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/catsone/cats-api-v3/revisions/dedbbade450d/schema)