List Contact Activities

curl --request GET \
  --url https://api.example.com/v1/contacts/{id}/activities

{
  "data": {
    "activities": [
      {
        "id": "<string>",
        "type": "<string>",
        "title": "<string>",
        "description": "<string>",
        "contact_id": "<string>",
        "deal_id": "<string>",
        "entity_type": "<string>",
        "entity_id": "<string>",
        "entity_name": "<string>",
        "metadata": {},
        "created_by_user_id": "<string>",
        "created_date": "<string>"
      }
    ]
  },
  "meta": {
    "page": 123,
    "per_page": 123,
    "total": 123
  }
}

GET

contacts

{id}

activities

List Contact Activities

curl --request GET \
  --url https://api.example.com/v1/contacts/{id}/activities

{
  "data": {
    "activities": [
      {
        "id": "<string>",
        "type": "<string>",
        "title": "<string>",
        "description": "<string>",
        "contact_id": "<string>",
        "deal_id": "<string>",
        "entity_type": "<string>",
        "entity_id": "<string>",
        "entity_name": "<string>",
        "metadata": {},
        "created_by_user_id": "<string>",
        "created_date": "<string>"
      }
    ]
  },
  "meta": {
    "page": 123,
    "per_page": 123,
    "total": 123
  }
}

Request

Path Parameters

string

required

The contact’s unique ID (UUID)

Query Parameters

page

integer

default:"1"

Page number for pagination

per_page

integer

default:"50"

Activities per page (max: 100)

type

string

Filter by activity type: call, email, meeting, note, task, ai_action, deal_stage_change, list_added, campaign_sent, etc.

from_date

string

Only activities on or after this ISO 8601 timestamp

to_date

string

Only activities on or before this ISO 8601 timestamp

Headers

Authorization: Bearer wbk_your_api_key_here

Requires an API key with the activities:read permission. Activities are returned newest first.

Response

data

object

Show properties

activities

array

Array of activity objects, newest first.

Show Activity object

string

Activity UUID

type

string

Activity type (see type filter)

title

string

Short human-readable title

description

string

Full description or body

contact_id

string

Linked contact UUID

deal_id

string

Linked deal UUID (nullable)

entity_type

string

Type of related entity (deal, task, email, campaign)

entity_id

string

UUID of related entity

entity_name

string

Human-readable name of related entity

metadata

object

Type-specific metadata (e.g., call duration, meeting attendees, email subject)

created_by_user_id

string

UUID of the user (or system) that created the activity

created_date

string

ISO 8601 timestamp

Example Response

{
  "data": {
    "activities": [
      {
        "id": "act_7f3c4d2a",
        "type": "email",
        "title": "Sent: Quick question about Acme Corp",
        "description": "Hi Jane, ...",
        "contact_id": "123e4567-e89b-12d3-a456-426614174000",
        "deal_id": "3f8e1d2c-4b5a-6d7e-8f9a-0b1c2d3e4f5a",
        "entity_type": "campaign",
        "entity_id": "cmp_abc123",
        "entity_name": "Q2 GC Outreach",
        "metadata": { "opened": true, "replied": false },
        "created_by_user_id": "9a8b7c6d-5e4f-3a2b-1c0d-9e8f7a6b5c4d",
        "created_date": "2026-04-17T14:23:05Z"
      }
    ]
  },
  "meta": { "page": 1, "per_page": 50, "total": 87 }
}

Errors

Status	Code	Description
401	`invalid_key`	Invalid or expired API key
403	`insufficient_permissions`	Missing `activities:read` permission
404	`contact_not_found`	No contact with this ID
429	`rate_limited`	Rate limit exceeded

List Users Create Activity

​Request

​Path Parameters

​Query Parameters

​Headers

​Response

​Example Response

​Errors

Request

Path Parameters

Query Parameters

Headers

Response

Example Response

Errors