Phone Call

A phone call record exposes a phone call to REST web services.

This record:

is not a subrecord
has one subrecord: EventFile

The REST API Browser includes information about the field names and field types of the phone call record, and about the HTTP methods, request parameters, and operations available to this record. For details, see the REST API Browser’s phone call reference page.

For information about using the REST API Browser, see The REST API Browser.

Record ID

The record ID for the phone call REST record is phonecall.

Exposed Elements

The following phone call record elements are exposed to REST web services:

accesslevel
assigned
bom (Requires Advanced Bill of Materials feature)
bomversion (Requires Advanced Bill of Materials feature)
company
completed date (a change here can be overwritten by change in status when set to completed in a separate modification, and cannot be set to custom date in the same message that completes the call)
contact
create date (Read only)
customform (Enumerated)
enddate
endtime
externalid
id
lastmodifieddate (Cannot be manually changed)
message
owner
phone
priority
relateditem
reminderminutes (Enumerated)
startdate
starttime
status
supportcase
timedvent
title
transaction
mfgrouting (Manufacturing Routing feature required)

Code Sample

In the following example, <accountID> represents your Account ID.

HTTP request: https://<accountID>/services/rest/record/v1/phonecall

Request Body

              { "title": "Call with Tom", "phone": "650-555-1234", "priority": "MEDIUM", "starttime": "16:30", "timedevent": true
}

To Obtain Previously-Created Phone Call Record (where ID is 100525)

HTTP Method: GET

URL: https://<accountID>/services/rest/record/v1/phonecall/100525

Response Body

              { "links": [ { "rel": "self", "http://<accountID>/services/rest/record/v1/phonecall/100525 } ], "accessLevel": false, "assigned": { "links": [ { "rel": "self", "href": "http://<accountID>/services/rest/record/v1/customer/-5" } ], "id": "-5", "refName": "A Wolfe-admin" }, "createdDate": "2020-11-25T16:54:00Z", "customForm": { "links": [], "id": "-150", "refName": "Standard Phone Call Form" }, "endTime": "17:30", "id": "100525", "lastModifiedDate": "2020-11-25T16:54:00Z", "owner": { "links": [ { "rel": "self", "href": "http://<acountID>/services/rest/record/v1/customer/-5" } ], "id": "-5", "refName": "-5" }, "phone": "650-555-1234", "priority": { "links": [], "id": "MEDIUM", "refName": "Medium" }, "sendEmail": false, "startDate": "2022-11-01", "startTime": "16:30", "status": { "links": [], "id": "SCHEDULED", "refName": "Scheduled" }, "timedEvent": true, "timezone": "America/Los_Angeles", "title": "Call with Tom"
}