Download contact events
curl --request GET \
--url https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events' -Method GET -Headers $headers{
"items": [
{
"id": "<string>",
"from": {
"phone": "<string>",
"email": "<string>",
"socialUrl": "<string>",
"socialProfileId": "<string>",
"userId": "<string>",
"contactId": "<string>",
"avatar": {}
},
"to": [
{
"phone": "<string>",
"email": "<string>",
"socialUrl": "<string>",
"socialProfileId": "<string>",
"userId": "<string>",
"contactId": "<string>",
"avatar": {}
}
],
"subject": "<string>",
"isSent": true,
"content": "<string>",
"attachments": [
{
"id": "<string>",
"name": "<string>",
"mediaType": "<string>",
"reference": "<string>",
"byteSize": 123
}
],
"participantsNr": 123,
"type": {
"id": "<string>",
"value": "<string>",
"description": "<string>",
"isInteraction": true,
"color": "<string>",
"iconName": "<string>",
"platform": "<string>"
},
"eventCreatedAt": "2023-11-07T05:31:56Z",
"jobSpecId": "<string>"
}
],
"count": 19
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}Contacts
Download Contact Events
Download recent Jobin contact timeline events across email, SMS, social, sequence, and system activity.
GET
/
contacts
/
{contactId}
/
events
Download contact events
curl --request GET \
--url https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events \
--header 'x-api-key: <api-key>'const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)$headers=@{}
$headers.Add("x-api-key", "<api-key>")
$response = Invoke-WebRequest -Uri 'https://my.jobin.cloud/api/openapi/v1/contacts/{contactId}/events' -Method GET -Headers $headers{
"items": [
{
"id": "<string>",
"from": {
"phone": "<string>",
"email": "<string>",
"socialUrl": "<string>",
"socialProfileId": "<string>",
"userId": "<string>",
"contactId": "<string>",
"avatar": {}
},
"to": [
{
"phone": "<string>",
"email": "<string>",
"socialUrl": "<string>",
"socialProfileId": "<string>",
"userId": "<string>",
"contactId": "<string>",
"avatar": {}
}
],
"subject": "<string>",
"isSent": true,
"content": "<string>",
"attachments": [
{
"id": "<string>",
"name": "<string>",
"mediaType": "<string>",
"reference": "<string>",
"byteSize": 123
}
],
"participantsNr": 123,
"type": {
"id": "<string>",
"value": "<string>",
"description": "<string>",
"isInteraction": true,
"color": "<string>",
"iconName": "<string>",
"platform": "<string>"
},
"eventCreatedAt": "2023-11-07T05:31:56Z",
"jobSpecId": "<string>"
}
],
"count": 19
}{
"statusCode": 429,
"error": "Too Many Requests",
"message": "<string>",
"retryAfterSeconds": 123
}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
Primary public authentication method. Create keys in Jobin.cloud under Workgroups > Integrations > Custom integration.
Path Parameters
Jobin contact identifier.
Pattern:
^[a-fA-F0-9]{24}$Query Parameters
Return events created before this timestamp.
Maximum events to download. Capped at 20.
Required range:
1 <= x <= 20Response
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.
