---
title: "Record a sales follow-up step"
method: POST
path: "/v1/admin/opportunities/accounts/{organizationId}/actions"
tags: ["Admin"]
---

# Record a sales follow-up step

`POST /v1/admin/opportunities/accounts/{organizationId}/actions`

## Request

- Base URL: `https://api.openworklabs.com`
- URL: `https://api.openworklabs.com/v1/admin/opportunities/accounts/{organizationId}/actions`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Platform-admin-only. Appends what happened (reviewed, contacted, reply, meeting, note, closed, dismissed or reopened) and sets the next action, owner and UTC follow-up date in one idempotent request. Never sends a message, changes the organization or writes to its audit log.

## Path parameters

- `organizationId` string, required

## Request body

- AccountFollowUpActionInput
  - `requestId` string, uuid, required
  - `kind` 'reviewed' | 'contacted' | 'replied' | 'meeting' | 'note' | 'closed' | 'dismissed' | 'reopened', required
  - `contactUserId` string, nullable
  - `note` string, nullable
  - `nextAction` string, nullable
  - `followUpOn` string, date, nullable: UTC calendar date (YYYY-MM-DD) of the next follow-up. Null clears it.
  - `assignToMe` boolean
  - `confirmedOpportunity` 'expansion' | 'commercial', nullable

## Response `200`

Step recorded, or the original retry returned.

- object
  - `ok` true, required
  - `actionId` string, required

## Other responses

- `400`: Invalid organization, contact or follow-up date.
- `401`: Authentication required.
- `403`: Platform admin access required.
- `404`: Organization not found.

## Changes

- **2026-10-23** `c93387179b31`: 1 info
  - response property `details/items/path/items/` list-of-types was narrowed by removing types `number` from media type `application/json` of response `400`
- **2026-10-22** `22a4e8c36059`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openworklabs/apis/den-api/changes/v1/admin/opportunities/accounts/:organizationId/actions/post.md)

---

[API](https://skmtc.dev/openworklabs/apis/den-api.md) - [All operations](https://skmtc.dev/openworklabs/apis/den-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openworklabs/apis/den-api/revisions/8170cf4a92ca?raw)