---
title: "Changes to Create an interaction"
method: POST
path: "/v1/interactions"
---

# Changes to Create an interaction

`POST /v1/interactions`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `c6818f3ba60d`: 1 breaking, 20 info

## Changes

- **2026-11-03** `c6818f3ba60d`: 1 breaking, 20 info
  - added `subschema #1, subschema #2` to the `data/from` response property `oneOf` list for the response status `200`
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new `instagram` enum value to the request property `activityType/anyOf[subschema #3]/`
  - added the new `instagram` enum value to the request property `type/anyOf[subschema #3]/`
  - added the new `tiktok` enum value to the request property `activityType/anyOf[subschema #3]/`
  - added the new `tiktok` enum value to the request property `type/anyOf[subschema #3]/`
  - added the non-success response with the status `409`
  - added the optional property `data/to/picture` to the response with the `200` status
  - added the optional property `data/to/userId` to the response with the `200` status
  - added `subschema #3, subschema #4` to the `data/activityType` response property `anyOf` list for the response status `200`
  - added `subschema #3, subschema #4` to the `data/type` response property `anyOf` list for the response status `200`
  - removed `subschema #2, subschema #3` from the `data/activityType` response property `anyOf` list for the response status `200`
  - removed `subschema #2, subschema #3` from the `data/type` response property `anyOf` list for the response status `200`
  - the response property `error/details` became required for the status `429`
  - removed `subschema #1, subschema #2` from the `data/from` response property `oneOf` list for the response status `200`
  - added the required property `error/details/limit` to the response with the `429` status
  - added the required property `error/details/policies` to the response with the `429` status
  - added the required property `error/details/policy` to the response with the `429` status
  - added the required property `error/details/remaining` to the response with the `429` status
  - added the required property `error/details/retryAfter` to the response with the `429` status
  - added the required property `error/details/windowSeconds` to the response with the `429` status

---

[Operation](https://skmtc.dev/folk/apis/folk-external-api/docs/v1/interactions/post.md) - [API](https://skmtc.dev/folk/apis/folk-external-api.md) - [Page](https://skmtc.dev/folk/apis/folk-external-api/changes/v1/interactions/post)