CRM

Log a Call/Meeting/Email/Task that happened outside Model Match

postapi.modelmatch.com/v1/crm/activity/log

Authorization

x-api-keystringrequired

API key or OAuth token. See Authentication.

Body application/json

activityTypeenumrequired

Options:callmeetingemailtask

bodystringrequired

bodyHtmlstring | null

directionenum | null

call + email only.

Options:inboundoutboundnull

durationMinutesinteger | null

call + meeting only, in minutes.

entityIdstringrequired

grantRecordAccessUserIdsstring[]

listIdstring | null

occurredAtintegerrequired

Epoch ms the activity actually happened. Must be ≤ now + 5 minutes.

outcomestring | null

call: connected | voicemail | no_answer | busy. meeting: held | no_show. Not allowed for email/task.

recordNamestring

titlestring | null

Meeting title / email subject / task title. Not allowed for a call; required for a task.

Responses

200objectThe new logged entry's id.

Show attributes

dataobjectrequired

Show child attributes

idstringrequired

400objectValidation error

401objectUnauthorized

403objectForbidden (authenticated, but missing required context — e.g. no active organization)

404objectNot found

413objectResponse payload too large — detail endpoint capped to fit Lambda response limits

503objectSearch timed out or the cluster is overloaded — retry after `Retry-After` seconds.

curl -X POST "https://api.modelmatch.com/v1/crm/activity/log" \
  -H "x-api-key: $MODEL_MATCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "activityType": "call",
    "body": "<string>",
    "entityId": "<string>",
    "occurredAt": 123,
    "direction": "inbound",
    "bodyHtml": "<string>",
    "durationMinutes": 123,
    "listId": "<string>",
    "outcome": "<string>",
    "recordName": "<string>"
  }'

import { createClient, Crm } from "@model-match/api";

createClient({ apiKey: process.env.MODEL_MATCH_API_KEY });

const { data, error } = await Crm.logCrmActivity({
  body: {
    activityType: "call",
    body: "<string>",
    entityId: "<string>",
    occurredAt: 123,
    direction: "inbound",
    bodyHtml: "<string>",
    durationMinutes: 123,
    listId: "<string>",
    outcome: "<string>",
    recordName: "<string>"
  }
});

import os
import requests

res = requests.post(
    "https://api.modelmatch.com/v1/crm/activity/log",
    headers={"x-api-key": os.environ["MODEL_MATCH_API_KEY"]},
    json={
        "activityType": "call",
        "body": "<string>",
        "entityId": "<string>",
        "occurredAt": 123,
        "direction": "inbound",
        "bodyHtml": "<string>",
        "durationMinutes": 123,
        "listId": "<string>",
        "outcome": "<string>",
        "recordName": "<string>"
    },
)
data = res.json()

200 response

{
  "data": {
    "id": "<string>"
  }
}