Skip to main content
GET
Download contact events
Use this endpoint when your integration needs the contact’s activity timeline. The response combines the same kinds of activity that appear on a contact timeline in Jobin, including emails, SMS messages, social interactions, sequence activity, pipeline movement, enrichment or profile updates, and system events. Each event includes direction, participants, content when available, event type metadata, attachments when available, and the time the activity occurred. Use beforeDate to page backward through older activity. Requests are heavily rate limited and return at most 20 events per call.

Authorizations

x-api-key
string
header
required

Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.

Path Parameters

contactId
string
required

Jobin contact identifier.

Pattern: ^[a-fA-F0-9]{24}$

Query Parameters

beforeDate
string<date-time>

Return events created before this timestamp.

limit
integer
default:10

Maximum events to download. Capped at 20.

Required range: 1 <= x <= 20

Response

Downloaded contact timeline event batch

Downloaded contact timeline event batch. The batch can include email, SMS, social interactions, sequence activity, pipeline movement, enrichment or profile updates, and system events for the contact.

items
object[]
Maximum array length: 20
count
integer

Number of events returned in this response.

Required range: x <= 20