Log a call
Log a call on a record with direction, status, time and notes.
POST https://cotlet.dev/api/v1/suitecrm/calls
write
Creates the call on the record you name, and it shows in its Activities or History tile by Status. It adds no invitees and sends no invitations, so it reaches no one and does not wait for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| subject string required | string | Subject of the call. |
| direction string required | string | Inbound or Outbound. |
| status string required | string | Planned, Held or Not Held. |
| start string required | string | Start date and time, ISO 8601. |
| duration_hours integer | integer | Hours of duration. |
| duration_minutes integer | integer | Minutes of duration. |
| related_to_module string | string | Module of the record it belongs to: Accounts, Contacts, Leads, Opportunities or Cases. |
| related_to_id string | string | Record ID of the record it belongs to. |
| description string | string | Notes of the call. |
Request
curl -X POST https://cotlet.dev/api/v1/suitecrm/calls \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subject":"Pricing questions with Tom Becker","direction":"Outbound","status":"Held","start":"2026-10-22T14:30:00","duration_hours":0,"duration_minutes":25,"related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61","description":"Asked about onboarding scope and price. Wants the revised quote with two seats."}'result = client.call("suitecrm", "log_call", {"subject":"Pricing questions with Tom Becker","direction":"Outbound","status":"Held","start":"2026-10-22T14:30:00","duration_hours":0,"duration_minutes":25,"related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61","description":"Asked about onboarding scope and price. Wants the revised quote with two seats."})const result = await cotlet.call('suitecrm', 'log_call', {"subject":"Pricing questions with Tom Becker","direction":"Outbound","status":"Held","start":"2026-10-22T14:30:00","duration_hours":0,"duration_minutes":25,"related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61","description":"Asked about onboarding scope and price. Wants the revised quote with two seats."});cotlet call suitecrm log_call --data '{"subject":"Pricing questions with Tom Becker","direction":"Outbound","status":"Held","start":"2026-10-22T14:30:00","duration_hours":0,"duration_minutes":25,"related_to_module":"Opportunities","related_to_id":"8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61","description":"Asked about onboarding scope and price. Wants the revised quote with two seats."}'Example response
{
"call_id": "f0c52d18-93ab-4e67-b1d4-6a8e2c5f7903",
"subject": "Pricing questions with Tom Becker",
"direction": "Outbound",
"status": "Held",
"start": "2026-10-22T14:30:00",
"duration": "0h 25m",
"related_to": {
"module": "Opportunities",
"id": "8f2a41c7-6d3e-90b5-17ac-4e5d0b9a2c61",
"name": "Northwind Dental: onboarding"
}
}