---
title: "Add a match indicator."
method: POST
path: "/matches"
tags: ["Add or Update"]
---

# Add a match indicator.

`POST /matches`

Add a match indicator. The job and the profile you refer to must have been uploaded before.

## Request body

- Match
  - `profile_id` string, required — The id of the entity doing the match action.
  - `job_id` string, required — The id of the entity receiving the match action.
  - `match_actor` 'CANDIDATE' | 'EMPLOYER' | 'CANDIDATE_AND_EMPLOYER' | 'INTERMEDIARY', required — An enumeration.
  - `match_datetime` string, date-time, required — The time at which the match action occured.
  - `match_type` 'PAGEVIEW' | 'SAVE' | 'APPLY' | 'RECOMMEND' | 'INVITE' | 'GOOD_MATCH' | 'BAD_MATCH' | 'INTERVIEW' | 'HIRE' | 'UNSAVE', required — An enumeration.
  - `metadata` MatchMetadata
    - `origin` 'LITTO_MATCHING' | 'SEARCH' | 'INTERNAL' | 'EXTERNAL' — An enumeration.
    - `direction` 'JOB2JOB' | 'PROFILE2JOB' — An enumeration.
    - `origin_id` string — The id of the entity which was used to compute the clicked recommendation. This field should only be filled in when matching triggered the click.
    - `client_data` object — Optional client-specific data.

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/talentapi/apis/talent-api-api-reference.md) · [All operations](https://skmtc.net/talentapi/apis/talent-api-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/talentapi/talent-api-api-reference/revisions/0798d0794573/schema)