/freshsales-activities | Type: Application | PCID required: Yes
Tools
freshsales_activities_create_appointment
Create an appointment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
appointment | object | Yes | — | Appointment fields. Common keys: title (required), description, from_date, end_date, location, is_allday, time_zone, outcome_id, conference_id, creater_id, owner_id, targetable_type, targetable_id, appointment_attendees_attributes (array of {attendee_type, attendee_id}). |
freshsales_activities_create_document_link
Attach a URL link to a CRM record Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
document_link | object | Yes | — | Link fields. Common keys: url (required), targetable_type (‘Contact’, ‘SalesAccount’, or ‘Deal’), targetable_id (integer — ID of the record to attach to), name (optional display name). |
freshsales_activities_create_file
Attach a file to a CRM record Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
document | object | Yes | — | File fields. Common keys: name (required), url (required — the file URL), targetable_type (‘Contact’, ‘SalesAccount’, or ‘Deal’), targetable_id (integer — ID of the record to attach to). |
freshsales_activities_create_note
Create a note Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
note | object | Yes | — | Note fields. Common keys: description (required), targetable_type (‘Contact’, ‘SalesAccount’, or ‘Deal’), targetable_id, creater_id. |
freshsales_activities_create_sales_activity
Create a sales activity Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
sales_activity | object | Yes | — | Sales activity fields. Common keys: title (required), sales_activity_type_id (required — from listSalesActivityTypes), targetable_type (‘Contact’ | ‘SalesAccount’ | ‘Deal’), targetable_id, owner_id, start_date, end_date, location, notes, latitude, longitude, outcome_id, custom_field (object of cf_* keys). |
freshsales_activities_create_task
Create a task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
task | object | Yes | — | Task fields. Common keys: title (required), description, due_date (ISO-8601), owner_id, status (0 = open, 1 = completed), targetable_type (e.g., ‘Contact’, ‘SalesAccount’, ‘Deal’), targetable_id, task_type_id, outcome_id, creater_id, workflow_id. Either targetable (with type + id) or top-level targetable_type + targetable_id is used. |
freshsales_activities_delete_appointment
Delete an appointment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the appointment. |
freshsales_activities_delete_note
Delete a note Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the note. |
freshsales_activities_delete_sales_activity
Delete a sales activity Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the sales activity. |
freshsales_activities_delete_task
Delete a task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the task. |
freshsales_activities_get_appointment
Get an appointment by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the appointment. |
freshsales_activities_get_sales_activity
Get a sales activity by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the sales activity. |
freshsales_activities_get_task
Get a task by ID Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the task. |
freshsales_activities_list_appointments
List appointments Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter | string | No | — | Filter appointments by time range. |
include | string | No | — | Comma-separated list of associations to side-load (e.g., “creater,targetable,appointment_attendees”). |
page | integer | No | — | Page number for paginated results (default 1). |
freshsales_activities_list_contact_document_associations
List files and links for a contact Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the contact. |
freshsales_activities_list_sales_activities
List sales activities Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
page | integer | No | — | Page number for paginated results (default 1). |
include | string | No | — | Comma-separated list of associated resources to side-load into the response. Valid values depend on the parent entity (e.g., for contacts: “creater,owner,updater,salesActivities,phoneNumbers,emails,tasks,appointments,notes”). |
freshsales_activities_list_sales_activity_fields
List sales activity field definitionsfreshsales_activities_list_tasks
List tasks Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter | string | No | — | Filter tasks by status. |
include | string | No | — | Comma-separated list of associations to side-load (e.g., “owner,targetable,users,creater,updater”). |
page | integer | No | — | Page number for paginated results (default 1). |
freshsales_activities_log_phone_call
Log a phone call Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
phone_call | object | Yes | — | Phone call log fields. Common keys: phone_number, note, call_direction (‘incoming’ or ‘outgoing’), outcome_id, targetable_type, targetable_id, from_date, to_date, duration, recording_url, creater_id. |
freshsales_activities_update_appointment
Update an appointment Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the appointment. |
appointment | object | Yes | — | Partial appointment fields to update. |
freshsales_activities_update_note
Update a note Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the note. |
note | object | Yes | — | Partial note fields to update. Typically used to edit description. |
freshsales_activities_update_sales_activity
Update a sales activity Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the sales activity. |
sales_activity | object | Yes | — | Partial sales-activity fields to update. |
freshsales_activities_update_task
Update a task Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
id | integer | Yes | — | Numeric ID of the task. |
task | object | Yes | — | Partial task fields to update. Set status: 1 to mark the task completed. |

