Skip to main content
POST
Add a note to a conversation

Path Parameters

conversationId
string
required

The conversation identifier.

Body

The create note request payload for the operation.

Defines the input used for create note.

text
string

Plain-text note content to add to the conversation timeline.

Response

Returns the event table row.

Summarizes event timeline data in paginated and searchable results.

id
string

Unique Leadping identifier for this event timeline table row.

eventType
string

Event type used to classify this timeline, SMS, call, or automation event.

eventCategory
null | string

High-level category used to group this Leadping event.

timelineType
enum<string>

Timeline type used to render this event in Leadping activity feeds.

Available options:
Message,
Sms,
Mms,
Call,
Voicemail,
Note,
LeadStatusChange,
LeadCreated,
LeadUpdated,
Notification,
Payment,
Warmup
timelineCategory
string

Timeline category used to group events for display and filtering.

description
string

Human-readable description that explains this event timeline table row to API users.

conversationId
null | string

Conversation ID that links this event timeline table row to the Leadping inbox thread.

leadId
null | string

Lead ID associated with this timeline event.

Related entity type connected to this event or notification.

Related entity ID connected to this event or notification.

summary
null | string

Short human-readable summary of this event timeline table row for lists, timelines, and notifications.

media
object[]

Media attached to an MMS timeline event.

direction
null | string

Communication direction for this event timeline table row, such as inbound or outbound.

status
null | enum<string>

Defines the supported Event timeline status values.

Available options:
Pending,
InProgress,
Completed,
Cancelled,
Scheduled,
Queued,
Sending,
Sent,
Received,
Delivered,
Undeliverable,
Opted out,
Blocked,
Initiated,
Ringing,
Active,
Ended,
Missed,
Voicemail,
Failed,
Canceled
statusReason
null | string

Human-readable reason explaining the current status of this event timeline table row.

trafficType
null | enum<string>

Defines the supported SMS Traffic Type values.

Available options:
RealLead,
Warmup,
Test,
SystemInternal,
FailedAttempt
fromPhoneNumberId
null | string

Sender phone number ID used for this outbound SMS or call.

outboundPhoneNumberId
null | string

Phone number ID selected for outbound delivery.

fromPhoneNumber
null | string

Sender phone number used for this communication.

toPhoneNumber
null | string

Recipient phone number used for this communication.

selectionReason
null | enum<string>

Defines the supported Outgoing Number Selection Reason values.

Available options:
StickyConversation,
LeadAssigned,
CampaignOrSource,
Preferred,
LocalArea,
HealthyPool,
FallbackDefault,
ManualOverride
wasManuallyOverridden
boolean

Indicates whether a user manually overrode Leadping's automatic number selection for this event timeline table row.

campaignId
null | string

Messaging campaign identifier associated with this event timeline table row.

sourceId
null | string

Lead source ID used for event attribution.

complianceAction
null | string

Compliance action applied to this message, lead, or sender.

billingStatus
null | string

Billing state for this communication, charge, or transaction.

billableAmount

Monetary amount billed for this Leadping communication or transaction.

errorCode
null | string

Machine-readable error code returned while processing this event timeline table row.

retryCount

Number of retry attempts already made for this event timeline table row.

queuedAt
null | string<date-time>

UTC timestamp when Leadping queued this event timeline table row for processing.

sendingStartedAt
null | string<date-time>

UTC timestamp when Leadping began sending this message.

sentAt
null | string<date-time>

UTC timestamp when Leadping sent this message to the provider.

deliveredAt
null | string<date-time>

UTC timestamp when the provider confirmed delivery.

receivedAt
null | string<date-time>

UTC timestamp when Leadping received this inbound event or message.

failedAt
null | string<date-time>

UTC timestamp when processing failed for this event timeline table row.

undeliverableAt
null | string<date-time>

UTC timestamp when the provider marked the message undeliverable.

blockedAt
null | string<date-time>

UTC timestamp when Leadping blocked this communication.

nextRetryAt
null | string<date-time>

UTC timestamp when Leadping will retry this event timeline table row.

scheduledFor
null | string<date-time>

UTC timestamp when the related delivery or workflow action is scheduled to run.

scheduledReason
null | string

Reason Leadping scheduled this delivery for a later time.

canceledAt
null | string<date-time>

UTC timestamp when this delivery or workflow was canceled.

cancelReason
null | string

Reason this delivery, run, or request was canceled.

createdAt
string<date-time>

UTC timestamp when this event timeline table row was created.

createdBy
string

Display name or identifier for the person or system that created this event timeline table row.

actorUserId
null | string

User ID for the person or system that created this event timeline table row.

actorDisplayName
null | string

Display name for the person or system that created this event timeline table row.

actorEmail
null | string

Email address for the person who created this event timeline table row.

Last modified on August 11, 2026