---
title: "Update a specific call"
description: "PUT /calls/{call_id} — Updates a call. The author display name stays with the original author."
canonical_url: https://developer.onepagecrm.com/api/reference/calls/put-calls-call_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/calls/put-calls-call_id/
---

`PUT /calls/{call_id}`

Updates a call. The author display name stays with the original author.

Resource: [Calls](https://developer.onepagecrm.com/api/reference/calls/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X PUT "https://app.onepagecrm.com/api/v3/calls/{call_id}" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "contact_id": "5ae06ef9d55673108fe8877f",
    "call_time_int": 1525273653,
    "text": "Mary is interested in coming into the office on Tuesday.",
    "phone_number": "(912) 644-1770 (mobile)",
    "call_result": "interested",
    "via": "phone",
    "recording_link": "",
    "user_ids_to_notify": [
      "5aba31e99007ba0f570c12f7"
    ]
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `call_id` | string | Call ID |

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `contact_id` | string (bson-id) |  | ID of the contact, to whom the call belongs |
| `call_time_int` | integer (unix-timestamp) |  | Time the call occurred in UNIX Epoch time in seconds (defaults to current time, if left blank). |
| `text` | string |  | Extra details related to the call (supports `[b]bold[/b]` and `[i]italic[/i]` formatting) |
| `phone_number` | string |  | Phone number used to make the call |
| `call_result` | string |  | Key of the `call_result` which best describes the result of the call |
| `via` | string |  | Through which application did the call take place |
| `recording_link` | string |  | URL of the recording of the call conversation |
| `user_ids_to_notify` | array<string (bson-id)> |  | A list of user IDs to notify |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "call": {
      "id": "5afc1b69d556730b580596cb",
      "contact_id": "5ae06ef9d55673108fe8877f",
      "text": "Mary is interested in coming into the office on Tuesday.",
      "call_result": "interested",
      "call_time_int": 1525273653,
      "via": "phone",
      "phone_number": "(912) 644-1770 (mobile)",
      "recording_link": "",
      "author": "Jane D.",
      "attachments": [
        {
          "id": "5afc1ea9d556730b780096db",
          "filename": "mario.jpg",
          "custom_filename": "another_mario.jpg",
          "pinned": true,
          "pinned_at": "2022-01-24T10:42:39Z",
          "size": 3841,
          "storage_provider": "amazon",
          "url": "https://{foo.bar}/mario.jpg",
          "url_expires_at": "2018-05-16T13:06:53Z",
          "thumbnail": {
            "url": "https://{foo.bar}/mario-thumbnail.jpg"
          }
        }
      ],
      "created_at": "2018-05-16T11:52:09Z",
      "modified_at": "2018-05-16T11:52:09Z",
      "index": 1
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Partial updates](https://developer.onepagecrm.com/api/partial-updates/)