interactions.create

Log an interaction with a contact

Request: POST/api/v1/contacts/{contactId}/interactions
Scope required: contacts:write
Effect: Changes data. Send an Idempotency-Key if you might retry it.
Acts on: Acts on the account’s own job search.
MCP tool: interactions_create
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Records that a conversation happened: which contact, what kind, when, and any note worth keeping. `interactionTime` is when the conversation took place, not when it is being written down, so backfilling last week's calls puts them where they belong on the timeline. Logging a `follow_up` is what puts the contact on the follow-up list `people.get_overview` answers with. Send an `Idempotency-Key` header if a retry must not log the same conversation twice.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
contactId	path	Required	string

Request body

interactionTime: string, required
notes: string or null, optional
type: one of: call, direct_message, email, follow_up, job_fair, meeting, networking_event, recruiter_outreach, reference_check, referral, social_media, thank_you_note, other, required

Response

contactId: string, required
createdAt: string, required
id: string, required
interactionTime: string, required
notes: string or null, required
type: one of: call, direct_message, email, follow_up, job_fair, meeting, networking_event, recruiter_outreach, reference_check, referral, social_media, thank_you_note, other, required
updatedAt: string, required

Examples

Record an email sent to a recruiter

Record an email sent to a recruiter — request

curl -s -X POST https://www.jobapplicationtracking.com/api/v1/contacts/ct_42/interactions \
  -H "Authorization: Bearer $JAT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "email",
  "notes": "Asked about the timeline for the platform team role.",
  "interactionTime": "2026-02-10T15:00:00.000Z"
}'

Record an email sent to a recruiter — response

{
  "id": "ix_88",
  "contactId": "ct_42",
  "type": "email",
  "notes": "Asked about the timeline for the platform team role.",
  "interactionTime": "2026-02-10T15:00:00.000Z",
  "createdAt": "2026-02-10T15:04:00.000Z",
  "updatedAt": "2026-02-10T15:04:00.000Z"
}