Sign in
latestOpenAPI 3.1.02026-08-233001841.3 MB

0dcf3303e9d7

activities.custom_activities

Create a new Custom Activity instance

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.

post/activity/custom/

Request body

activity_atstring date-time nullable
contact_idstring nullable
created_bystring nullable
custom_activity_type_idstring required
date_createdstring date-time nullable
lead_idstring required
organization_idstring nullable
pinnedboolean nullable
status'draft' | 'published'
user_idstring nullable

Response

Successful response

_typestring required
activity_atstring date-time nullable required
contact_idstring nullable required
created_bystring nullable required
created_by_namestring nullable
custom_activity_type_idstring required
date_createdstring date-time required
date_updatedstring date-time required
idstring required
last_published_atstring date-time nullable required
lead_idstring nullable required
mentionsstring[] required
mentions_updated_atstring date-time nullable required
organization_idstring required
pinnedboolean required
pinned_atstring 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_bystring nullable required
updated_by_namestring nullable
user_idstring nullable required
user_namestring nullable
usersstring[] required