Skip to main content

​
List interactions

​
page
integer
default:"1"
Page number
​
per_page
integer
default:"25"
Items per page (max 250)
​
sort
string
Sort field
​
order
string
default:"desc"
Sort order: asc or desc
​
q
string
Search query
​
contact_id
string
Filter by contact ID
​
deal_id
string
Filter by deal ID
​
type
string
Filter by type: call, email, meeting, note, demo, proposal
GET /api/v1/interactions
Example
curl "https://api.mosscrm.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
​
contact_id
string
required
Contact ID (UUID)
​
type
string
required
Type: call, email, meeting, note, demo, or proposal
​
deal_id
string
Associated deal ID (UUID)
​
notes
string
Interaction notes
​
occurred_at
string
required
When the interaction occurred (ISO 8601 datetime)
Example
curl -X POST https://api.mosscrm.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.