Interactions

List interactions

integer

default:"1"

Page number

integer

default:"25"

Items per page (max 250)

string

Sort field

string

default:"desc"

Sort order: asc or desc

string

Search query

string

Filter by contact ID

string

Filter by deal ID

string

Filter by type: call, email, meeting, note, demo, proposal

GET /api/v1/interactions

Example

curl "https://api.mossdesk.com/api/v1/interactions?contact_id=cnt_abc123&type=meeting" \
  -H "X-API-Key: moss_k_..."

Get an interaction

GET /api/v1/interactions/:id

Log an interaction

Interactions are immutable — they can be created and deleted, but not updated.

POST /api/v1/interactions

string

required

Contact ID (UUID)

string

required

Type: call, email, meeting, note, demo, or proposal

string

Associated deal ID (UUID)

string

Interaction notes

string

required

When the interaction occurred (ISO 8601 datetime)

Example

curl -X POST https://api.mossdesk.com/api/v1/interactions \
  -H "X-API-Key: moss_k_..." \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "cnt_abc123",
    "type": "meeting",
    "notes": "Discussed Q2 roadmap and SSO requirements",
    "occurred_at": "2026-02-08T14:00:00Z"
  }'

Delete an interaction

DELETE /api/v1/interactions/:id

Returns { "data": null } on success.

Overview

CRM Resources

Views & Search

Operations

List interactions

Get an interaction

Log an interaction

Delete an interaction

​List interactions

​Get an interaction

​Log an interaction

​Delete an interaction

List interactions

Get an interaction

Log an interaction

Delete an interaction