Skip to main content
GET
Get full lead event payload by ID

Authorizations

Authorization
string
header
required

Authorization header using the Bearer scheme. Accepted values are Leadping user JWT access tokens and WorkOS organization API keys beginning with sk_.

Path Parameters

eventId
string
required

The ID of the event.

Response

Event details were successfully retrieved.

Describes event detail data returned by Leadping.

eventType
string

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

secondaryEventType
null | string

Secondary event type used for additional event classification.

description
null | string

Human-readable description that explains this event detail response to API users.

eventCategory
null | string

High-level category used to group this Leadping event.

timelineType
null | enum<string>

Classifies the kind of activity displayed in a lead or conversation event timeline.

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

Timeline category used to group events for display and filtering.

conversationId
null | string

Conversation ID that links this event detail response to the Leadping inbox thread.

summary
null | string

Short human-readable summary of this event detail response for lists, timelines, and notifications.

direction
null | string

Communication direction for this event detail response, such as inbound or outbound.

status
null | enum<string>

Describes whether a Leadping event is pending, processing, completed, failed, or otherwise resolved.

Available options:
Pending,
InProgress,
Completed,
Failed,
Cancelled
statusReason
null | string

Human-readable reason explaining the current status of this event detail response.

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.

queuedAt
null | string<date-time>

UTC timestamp when Leadping queued this event detail response for processing.

scheduledFor
null | string<date-time>

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

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 detail response.

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.

canceledAt
null | string<date-time>

UTC timestamp when this delivery or workflow was canceled.

user
object | null

User summary connected to this event detail response.

userEmail
null | string<email>

Email address for the user connected to this event detail response.

userId
string

User ID associated with the activity that created this event.

leadId
null | string

Lead ID associated with this event detail record.

id
string

Stable unique identifier of the resource.

createdAt
string<date-time>

UTC timestamp when the resource was created.

modifiedAt
null | string<date-time>

UTC timestamp when the resource was last modified, or null when it has not been updated.