Skip to main content
POST
Create a conversation note event.

Path Parameters

conversationId
string
required

The conversation identifier.

Body

The create note request payload for the operation.

Request payload for create note.

text
string

The text value for this note.

Response

Returns the event table row.

List item schema for Leadping API event timeline table row results shown in searchable tables.

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
string | null

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,
Disposition,
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
string | null

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

leadId
string | null

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
string | null

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

direction
string | null

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

status
enum<string> | null

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
string | null

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

trafficType
enum<string> | null

Defines the supported SMS Traffic Type values.

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

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

outboundPhoneNumberId
string | null

Phone number ID selected for outbound delivery.

fromPhoneNumber
string | null

Sender phone number used for this communication.

toPhoneNumber
string | null

Recipient phone number used for this communication.

selectionReason
enum<string> | null

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
string | null

Messaging campaign identifier associated with this event timeline table row.

sourceId
string | null

Lead source ID used for event attribution.

complianceAction
string | null

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

billingStatus
string | null

Billing state for this communication, charge, or transaction.

billableAmount
string<double> | null

Monetary amount billed for this Leadping communication or transaction.

Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
errorCode
string | null

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

retryCount
string<int32>

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

Pattern: ^-?(?:0|[1-9]\d*)$
queuedAt
string<date-time> | null

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

sendingStartedAt
string<date-time> | null

UTC timestamp when Leadping began sending this message.

sentAt
string<date-time> | null

UTC timestamp when Leadping sent this message to the provider.

deliveredAt
string<date-time> | null

UTC timestamp when the provider confirmed delivery.

receivedAt
string<date-time> | null

UTC timestamp when Leadping received this inbound event or message.

failedAt
string<date-time> | null

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

undeliverableAt
string<date-time> | null

UTC timestamp when the provider marked the message undeliverable.

blockedAt
string<date-time> | null

UTC timestamp when Leadping blocked this communication.

nextRetryAt
string<date-time> | null

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

scheduledFor
string<date-time> | null

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

scheduledReason
string | null

Reason Leadping scheduled this delivery for a later time.

canceledAt
string<date-time> | null

UTC timestamp when this delivery or workflow was canceled.

cancelReason
string | null

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
string | null

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

actorDisplayName
string | null

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

actorEmail
string | null

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