Skip to main content
POST
Create Activity
Use this endpoint to record any user or agent action — a call, a sent email, a meeting, a handwritten note — so it appears on the contact and deal timeline.

Request

Headers

Requires an API key with the activities:write permission. Fires the activity.created webhook event.

Body Parameters

string
required
Activity type (e.g., call, email, email_sent, email_replied, meeting, note, task_completed, ai_action). Free-form — custom types are allowed.
string
Short human-readable title (max 500 chars)
string
Full description or body (markdown supported)
string
UUID of the related contact
string
UUID of the related deal
string
Polymorphic entity type (e.g., campaign, task, list) when the activity relates to something other than a contact or deal
string
UUID of the polymorphic entity
string
Human-readable name of the entity (for timeline display)
object
Arbitrary structured JSON for type-specific data (call duration, email subject, attendees, etc.). Max 8 KB serialized.

Response

object

Example Response

Errors