Skip to main content
GET
Download contact events
Review the contact’s recent activity before following up. 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 its type, participants, direction, and time, plus message content and attachments when available. Use beforeDate to page backward through older activity. Each page returns up to 20 events. Rate limit: 10 requests/minute per endpoint and workgroup. Details.

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