PIpipedrive
CallLogs

Add a call log

Changed on

Adds a new call log.

post/callLogs

Request

  • Base URL
    https://api.pipedrive.com/v1
  • Auth
    • API key in header x-api-token
    • or OAuth 2
      Authorization code: https://oauth.pipedrive.com/oauth/authorize
      Token URL: https://oauth.pipedrive.com/oauth/token scopes: phone-integration

Request body

user_idinteger

The ID of the owner of the call log. Please note that a user without account settings access cannot create call logs for other users.

activity_idinteger

If specified, this activity will be converted into a call log, with the information provided. When this field is used, you don't need to specify deal_id, person_id or org_id, as they will be ignored in favor of the values already available in the activity. The activity_id must refer to a call type activity.

subjectstring

The name of the activity this call is attached to

durationstring

The duration of the call in seconds

outcome'connected' | 'no_answer' | 'left_message' | 'left_voicemail' | 'wrong_number' | 'busy' required

Describes the outcome of the call

from_phone_numberstring

The number that made the call

to_phone_numberstring required

The number called

start_timestring date-time required

The date and time of the start of the call in UTC. Format: YYYY-MM-DD HH:MM:SS.

end_timestring date-time required

The date and time of the end of the call in UTC. Format: YYYY-MM-DD HH:MM:SS.

person_idinteger

The ID of the person this call is associated with

org_idinteger

The ID of the organization this call is associated with

deal_idinteger

The ID of the deal this call is associated with. A call log can be associated with either a deal or a lead, but not both at once.

lead_idstring uuid

The ID of the lead in the UUID format this call is associated with. A call log can be associated with either a deal or a lead, but not both at once.

notestring

The note for the call log in HTML format

Response

The call log was successfully created.

successboolean

If the response is successful or not

Changes

  • ffe4619b621aRevision changes
    • info

      added the new optional request property

    • info

      added the optional property // to the response with the status

  • 54c5a085a561Revision changes
    • breaking

      the response's body type changed from no type to object for status

    • info

      removed subschema #1: baseResponse subschema #2 from the response body allOf list for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status