---
title: "Create a custom activity."
method: POST
path: "/api/external/custom-activity/create"
tags: ["Other APIs"]
---

# Create a custom activity.

`POST /api/external/custom-activity/create`

## Headers

- `RF-Api-Key` string, required

## Request body

- object
  - `activity_text` string — The text describing the activity.
  - `activity_time` string — The time of the activity in ISO format.
  - `activity_type_id` integer — The id of the activity type.
  - `activity_user_id` integer — The id of the user who performed the activity.
  - `associated_entities` object — The associated entities for the activity.
    - `candidates` integer[] — The list of candidate ids associated with the activity.
    - `clients` integer[] — The list of client ids associated with the activity.
    - `contacts` integer[] — The list of contact ids associated with the activity.
    - `deals` integer[] — The list of deal ids associated with the activity.
    - `jobs` integer[] — The list of job ids associated with the activity.
  - `mentions` object[] — The list of mentions for the activity.
    - `id` integer — The id of the mentioned entity (user or team).
    - `type` integer — The type of mention (1 for user, 2 for team).
    - `value` string — The name/value of the mentioned entity.

## Response `200`

Auto generated using Swagger Inspector

## Other responses

- `400` — Auto generated using Swagger Inspector
- `404` — Auto generated using Swagger Inspector

## Changes

- **2026-08-13** `febc104d89ff` — 1 breaking
  - the `header` request parameter `RF-Api-Key` became required

[Change history](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/changes/api/external/custom-activity/create/post.md)

---

[API](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation.md) · [All operations](https://skmtc.dev/recruiterflow/apis/recruiterflow-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recruiterflow/recruiterflow-api-documentation/revisions/febc104d89ff/schema)