Create Call Log

Create Call Log

POST

Create a call log for a candidate, contact, or organization.

Request

POST /v1/call-log

Use application/json when sending a recording URL. Use multipart/form-data when uploading an audio file with the field name call_recording.

Body Parameters

Parameter	Type	Required	Description
call_direction	integer	Yes	Call direction. Allowed values: 1 incoming, 2 outgoing.
call_started_at	ISO 8601 string	Yes	Call start date and time. Example: 2026-07-24T10:30:00Z.
related_to_type_id	integer	Yes	Main related record type. Allowed values: 1 candidate, 4 contact, 3 organization.
related_to	string	Yes	Main related candidate, contact, or organization slug.
call_type_id	integer	No	Call type id. If omitted, ATZ CRM uses the default call type when available.
contact_number	string	No	Phone number used for the call.
call_notes	string	No	Notes about the call.
duration	string	No	Call duration. Examples: 1h 2m 10s, 5:30:50, 5:30, or total seconds such as 2500.
call_recording	string or file	No	Recording URL, or an uploaded audio file. Audio uploads support MP3, MP4/M4A, WAV, and WebM up to 25 MB.
associated_candidates	string	No	Comma-separated candidate slugs to associate with the call log.
associated_contacts	string	No	Comma-separated contact slugs to associate with the call log.
associated_organizations	string	No	Comma-separated organization slugs to associate with the call log.
associated_deals	string	No	Comma-separated deal slugs to associate with the call log.
associated_jobs	string	No	Comma-separated job slugs to associate with the call log.
created_by	integer	No	User id to use as the creator.
collaborator_user_ids	string	No	Comma-separated user ids to add as collaborators.

Request Example

{
  "call_direction": 2,
  "call_started_at": "2026-07-24T10:30:00Z",
  "related_to_type_id": 1,
  "related_to": "candidate_0d25558c1a77fc2d7d98",
  "contact_number": "+14155550100",
  "call_notes": "Discussed interview availability.",
  "duration": "12m 30s",
  "associated_contacts": "contact_68ba678fcd2a83f4640c",
  "collaborator_user_ids": "4,8"
}

Response

200

{
  "id": 128,
  "call_direction": 2,
  "call_type": {
    "id": 1,
    "label": "General"
  },
  "call_started_at": "2026-07-24 10:30:00 AM",
  "contact_number": "+14155550100",
  "call_notes": "Discussed interview availability.",
  "duration": "00:12:30",
  "related_to": "candidate_0d25558c1a77fc2d7d98",
  "related_to_type": 1,
  "related_record": {
    "slug": "candidate_0d25558c1a77fc2d7d98"
  },
  "created_at": "2026-07-24T10:30:00.000Z",
  "updated_at": "2026-07-24T10:30:00.000Z",
  "created_by": {
    "id": 1
  },
  "updated_by": {
    "id": 1
  },
  "call_recording": null,
  "associated_candidates": [],
  "associated_contacts": [
    "contact_68ba678fcd2a83f4640c"
  ],
  "associated_organizations": [],
  "associated_deals": [],
  "associated_jobs": [],
  "collaborator_users": [
    {
      "id": 4
    },
    {
      "id": 8
    }
  ]
}

400

[
  {
    "field_name": "call_direction",
    "error_message": "call_direction is required"
  }
]