Interactions API

Track meetings, calls, emails, and other touchpoints

Overview

The Interactions API tracks all touchpoints with companies and contacts including meetings, calls, emails, and notes.

Base Path: /api/interactions

Endpoints

Create Interaction

POST /api/interactions

Request Body:

{
  "type": "meeting",
  "company_id": "550e8400-e29b-41d4-a716-446655440000",
  "contact_ids": ["dd0e8400-e29b-41d4-a716-446655440888"],
  "subject": "Partnership discussion",
  "notes": "Discussed Q1 partnership opportunities...",
  "date": "2024-01-22T14:00:00Z",
  "duration_minutes": 60
}

Interaction Types:

• meeting - In-person or video meeting
• call - Phone call
• email - Email communication
• note - General note

Response (201 Created):

{
  "id": "jj0e8400-e29b-41d4-a716-446655444444",
  "type": "meeting",
  "company_id": "550e8400-e29b-41d4-a716-446655440000",
  "subject": "Partnership discussion",
  "created_at": "2024-01-22T14:00:00Z"
}

List Interactions

GET /api/interactions?company_id={company_id}

Next Steps

Companies API

Company management

Contacts API

Contact management