---
title: "Create follow up"
method: POST
path: "/crm/follow-ups"
---

# Create follow up

`POST /crm/follow-ups`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/crm/follow-ups`
- Auth: HTTP bearer

Requires `crm:followups:write`. Creates one follow-up using current CRM rules. Does not enable automation. This creation is not idempotent; reconcile after an ambiguous response before retrying.

## Request body

- object
  - `leadId` string, required
  - `conversationId` string
  - `reason` string, required
  - `messageDraft` string
  - `dueAt` string, date-time

## Response `201`

Success

- PublicFollowUpResult
  - `followUp` PublicFollowUp, required
    - `followUpId` string, required
    - `opportunityId` string
    - `leadId` string, required
    - `conversationId` string
    - `channel` string
    - `status` string, required
    - `mode` string, required
    - `reasonCode` string
    - `reasonText` string
    - `reason` string
    - `messageDraft` string
    - `draftStatus` string
    - `dueAt` string
    - `expiresAt` string
    - `sentAt` string
    - `replyId` string
    - `createdAt` string
    - `updatedAt` string

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)