---
title: "Create a new Custom Activity instance"
method: POST
path: "/activity/custom/"
tags: ["activities.custom_activities"]
---

# Create a new Custom Activity instance

`POST /activity/custom/`

Custom Activity instances will be created by default with the 'published' status. All required fields will be validated in this status. To create an activity without setting all required fields, you can use the "draft" status.

A Custom Activity can be pinned or unpinned by setting the `pinned` field to `true` or `false` when creating or updating a Custom Activity.

Custom Fields appear in the format: `custom.{custom_field_id}`. See [Custom Fields](https://developer.close.com/api/resources/custom-fields/custom-fields-activity).

## Request body

- CreateCustomActivity
  - `activity_at` string, date-time, nullable
  - `contact_id` string, nullable
  - `created_by` string, nullable
  - `custom_activity_type_id` string, required
  - `date_created` string, date-time, nullable
  - `lead_id` string, required
  - `organization_id` string, nullable
  - `pinned` boolean, nullable
  - `status` 'draft' | 'published'
  - `user_id` string, nullable

## Response `200`

Successful response

- CustomActivity
  - `_type` string, required
  - `activity_at` string, date-time, nullable, required
  - `comment_summary` CommentSummary
    - `comment_count` integer, required
    - `thread_id` string, required
  - `contact_id` string, nullable, required
  - `created_by` string, nullable, required
  - `created_by_name` string, nullable
  - `custom_activity_type_id` string, required
  - `date_created` string, date-time, required
  - `date_updated` string, date-time, required
  - `id` string, required
  - `last_published_at` string, date-time, nullable, required
  - `lead_id` string, nullable, required
  - `mentions` string[], required
  - `mentions_updated_at` string, date-time, nullable, required
  - `organization_id` string, required
  - `pinned` boolean, required
  - `pinned_at` string, date-time, nullable, required
  - `source` 'ui' | 'api' | 'import' | 'clipper' | 'email' | 'suggestion' | 'segment-integration' | 'customerio-integration' | 'calendly-integration' | 'ai' | 'whatsapp' | 'webform', required
  - `status` 'draft' | 'published', required
  - `updated_by` string, nullable, required
  - `updated_by_name` string, nullable
  - `user_id` string, nullable, required
  - `user_name` string, nullable
  - `users` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/close/apis/close-api.md) · [All operations](https://skmtc.net/close/apis/close-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/close/close-api/revisions/0dcf3303e9d7/schema)