---
title: "POST /wordlift/v1/post-matches/{post_id}/matches"
method: POST
path: "/wordlift/v1/post-matches/{post_id}/matches"
tags: ["Post Matches"]
---

# POST /wordlift/v1/post-matches/{post_id}/matches

`POST /wordlift/v1/post-matches/{post_id}/matches`

## Request

- Base URL: `https` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `https/wordlift/v1/post-matches/{post_id}/matches`
- Auth: none declared
- TypeScript: <https://skmtc.dev/insideout10/apis/wordlift-plugin/docs/wordlift/v1/post-matches/:post_id/matches/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a post match for the given post ID.

## Path parameters

- `post_id` integer, required

## Response `201`

Created

- PostMatch
  - `id` integer, required
  - `post_title` string, required
  - `post_status` string, required
  - `parent_post_title` string
  - `parent_post_id` string
  - `parent_post_link` string
  - `match_jsonld` string
  - `match_id` integer
  - `match_name` string
  - `post_link` string, required
  - `view_link` string, required
  - `preview_link` string, required

## Changes

- **2023-07-13** `18ae40c3d22f`: 1 info
  - endpoint added
- **2023-04-17** `f968547046e0`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/insideout10/apis/wordlift-plugin/changes/wordlift/v1/post-matches/:post_id/matches/post.md)

---

[API](https://skmtc.dev/insideout10/apis/wordlift-plugin.md) - [All operations](https://skmtc.dev/insideout10/apis/wordlift-plugin/llms.txt) - [OpenAPI document](https://skmtc.dev/insideout10/apis/wordlift-plugin/revisions/00576e6d31eb?raw)