---
title: "Create sequence activity"
method: POST
path: "/v2/sequences/activities"
tags: ["Sequence Activities"]
---

# Create sequence activity

`POST /v2/sequences/activities`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/sequences/activities`
- Auth: HTTP bearer

Create a new sequence activity (note) and update the associated lead

## Request body

- CreateActivityRequest: Request to create a new sequence activity
  - `sequence_lead_id` string, required: Encrypted lead identifier
  - `activity_type` 'note', required
  - `user_action` 'add_note_replan' | 'add_note' | 'finish' | 'snooze' | 'remove', required: Type of user action that creates an activity. `add_note` records a note (e.g. guidance for the AI to improve future emails) WITHOUT triggering a replan; `add_note_replan` records a note and reschedules the lead.
  - `note` string
  - `snooze_duration` '1_day' | '3_days' | '1_week': Duration for snoozing a lead
  - `activity_id` string: Encrypted activity identifier

## Response `200`

Activity created successfully

- object
  - `data` CreateActivityResponse, required: Standardized response after creating a sequence activity or performing lead actions
    - `id` string, nullable, required: Encrypted activity identifier
    - `sequence_lead_id` string, required: Encrypted lead identifier
    - `activity_type` 'incoming_email' | 'outgoing_email' | 'note', nullable, required: Type of sequence activity
    - `note` string, nullable, required
    - `created_at` string, date-time, nullable, required
    - `message` string, required
    - `next_followup_at` string, date-time, nullable, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Invalid request data
- `401`: Unauthorized - missing or invalid authentication
- `404`: Sequence lead not found

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)