Table of Contents | ||
---|---|---|
|
GET activities/show
This method returns information related with an activity. Single activity is returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
(mandatory)
...
Activity identifier
The identifier of the activity that should be returned as a result. The allowed activities identifier fields are the following:
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
GET activities/list
This method returns information related with activities. Multiple activities are returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
(semi-optional)
...
Activity type identifier
The identifier of the activity type. The allowed activity type identifier fields are the following:
...
(semi-optional)
...
The identifier of the contact information related with the account that will be returned as results. The allowed contact information identifier fields are the following:
...
number_of_results
(optional)
...
The number of results that can be retrieved through each call
Tip |
---|
Available from CRM.COM R13.0.0 |
...
offset
(optional)
...
Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number
Tip |
---|
Available from CRM.COM R13.0.0 |
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
GET activities/get_close_to_estimated_completion_time
This method returns information related with activities which are close to their estimated completion time. Multiple activities are returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
period
(mandatory)
...
(mandatory)
...
MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS
...
contact_information_identifier
(optional)
...
The identifier of the contact information (person or company) for which the retrieved activity is planned for
...
type_identifier
(optional)
...
The identifier of the type of the retrieved activity
...
category_identifier
(optional)
...
The identifier of the category of the retrieved activity
...
number_of_results
(optional)
...
The number of results that can be retrieved through each call
Tip |
---|
Available from CRM.COM R13.0.0 |
...
offset
(optional)
...
Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number
Tip |
---|
Available from CRM.COM R13.0.0 |
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
GET activities/get_overdue
This method returns information related with the activities which are overdue. Multiple activities are returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
contact_information_identifier
(optional)
...
The identifier of the contact information (person or company) for which the retrieved activity is planned for
...
type_identifier
(optional)
...
The identifier of the type of the retrieved activity
...
category_identifier
(optional)
...
The identifier of the category of the retrieved activity
...
number_of_results
(optional)
...
The number of results that can be retrieved through each call
Tip |
---|
Available from CRM.COM R13.0.0 |
...
offset
(optional)
...
Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number
Tip |
---|
Available from CRM.COM R13.0.0 |
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
GET activities/get_pending
This method returns information related with activities which are in pending life cycle state
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
contact_information_identifier
(optional)
...
The identifier of the contact information (person or company) for which the retrieved activity is planned for
...
type_identifier
(optional)
...
The identifier of the type of the retrieved activity
...
category_identifier
(optional)
...
The identifier of the category of the retrieved activity
...
number_of_results
(optional)
...
The number of results that can be retrieved through each call
Tip |
---|
Available from CRM.COM R13.0.0 |
...
offset
(optional)
...
Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number
Tip |
---|
Available from CRM.COM R13.0.0 |
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
GET activities/get_in_progress
This method returns information related with activities which are in the in progress life cycle state. Multiple activities are returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
contact_information_identifier
(optional)
...
The identifier of the contact information (person or company) for which the retrieved activity is planned for
...
type_identifier
(optional)
...
The identifier of the type of the retrieved activity
...
category_identifier
(optional)
...
The identifier of the category of the retrieved activity
...
number_of_results
(optional)
...
The number of results that can be retrieved through each call
Tip |
---|
Available from CRM.COM R13.0.0 |
...
offset
(optional)
...
Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number
Tip |
---|
Available from CRM.COM R13.0.0 |
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
GET activities/get_completed
This method returns information related with completed activities. Multiple activities are returned by each call
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
contact_information_identifier
(optional)
...
The identifier of the contact information (person or company) for which the retrieved activity is planned for
...
type_identifier
(optional)
...
The identifier of the type of the retrieved activity
...
category_identifier
(optional)
...
The identifier of the category of the retrieved activity
...
number_of_results
(optional)
...
The number of results that can be retrieved through each call
Tip |
---|
Available from CRM.COM R13.0.0 |
...
offset
(optional)
...
Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number
Tip |
---|
Available from CRM.COM R13.0.0 |
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
GET activities/get_cancelled
This method returns information related with cancelled activities. Multiple activities are returned by each call
Tip |
---|
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
contact_information_identifier
(optional)
...
The identifier of the contact information (person or company) for which the retrieved activity is planned for
...
type_identifier
(optional)
...
The identifier of the type of the retrieved activity
...
category_identifier
(optional)
...
The identifier of the category of the retrieved activity
...
number_of_results
(optional)
...
The number of results that can be retrieved through each call
Tip |
---|
Available from CRM.COM R13.0.0 |
...
offset
(optional)
...
Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise the results will begin from the provided offset number
Tip |
---|
Available from CRM.COM R13.0.0 |
...
fields_set
(optional)
...
List of Strings, comma separated
...
A list of fields that should be included in the results. If not specified then all the available fields will be returned
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
| |||||||||
HTTP Method: GET
Request: Response:
|
POST activities/create
This method creates an activity. Single activities can be created by each call. Only customer activities can be created through this method.
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
type_identifier
(mandatory)
...
The type of the activity. The allowed activity type identifiers are the following:
...
contact_information_identifier
(mandatory)
...
The contact information related with the activity. The allowed contact information identifiers are the following:
...
category_identifier
(optional)
...
The category of the activity. The allowed activity category identifiers are the following:
...
status_identifier
(optional)
...
The status of the activity. If not specified then the default status will be set automatically.The allowed activity status identifiers are the following:
...
description
(optional)
...
notes
(optional)
...
start_date
(optional)
...
owned_by_group_identifier
(mandatory)
...
The owned by group information of the activity. The allowed group identifier fields are the following:
...
privacy_level_identifier
(optional)
...
The privacy level of the activity. The allowed privacy level identifier fields are the following:
...
udf_string_1
(optional)
...
User Defined Field of type String
...
udf_string_2
(optional)
...
User Defined Field of type String
...
udf_string_3
(optional)
...
User Defined Field of type String
...
udf_string_4
(optional)
...
User Defined Field of type String
...
udf_string_5
(optional)
...
User Defined Field of type String
...
udf_string_6
(optional)
...
User Defined Field of type String
...
udf_string_7
(optional)
...
User Defined Field of type String
...
udf_string_8
(optional)
...
User Defined Field of type String
...
udf_float_1
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_2
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_3
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_4
(optional)
...
Float
...
User Defined Field of type Float
...
udf_date_1
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_2
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_3
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_4
(optional)
...
Date
...
User Defined Field of type Date
...
expected_completion_date
(semi-optional)
...
(semi-optional)
...
(optional)
...
The assignment information of the activity
...
(optional)
...
The entities which are related with the activity
...
(optional)
...
The information related to the services to be provided with the activity
...
fields_set
(optional)
...
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
HTTP Method: POST
Request: Body:
Response:
|
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
HTTP Method: POST
Request: Body:
Response:
|
POST activities/update
This method updates activities. Single activities can be updated by each call. Fields which are not specified are not updated at all. Fields which are specified as null will be set as null.
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
activity_identifier
(mandatory)
...
The identifier of the activity to be updated. The allowed activity identifier fields are the following:
...
category_identifier
(optional)
...
The category of the activity. The allowed activity category identifiers are the following:
...
status_identifier
(optional)
...
The status of the activity. The allowed activity status identifiers are the following:
...
description
(optional)
...
notes
(optional)
...
start_date
(optional)
...
owned_by_group_identifier
(optional)
...
The owned by group information of the activity. The allowed group identifier fields are the following:
...
privacy_level_identifier
(optional)
...
The privacy level of the activity. The allowed privacy level identifier fields are the following:
...
udf_string_1
(optional)
...
User Defined Field of type String
...
udf_string_2
(optional)
...
User Defined Field of type String
...
udf_string_3
(optional)
...
User Defined Field of type String
...
udf_string_4
(optional)
...
User Defined Field of type String
...
udf_string_5
(optional)
...
User Defined Field of type String
...
udf_string_6
(optional)
...
User Defined Field of type String
...
udf_string_7
(optional)
...
User Defined Field of type String
...
udf_string_8
(optional)
...
User Defined Field of type String
...
udf_float_1
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_2
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_3
(optional)
...
Float
...
User Defined Field of type Float
...
udf_float_4
(optional)
...
Float
...
User Defined Field of type Float
...
udf_date_1
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_2
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_3
(optional)
...
Date
...
User Defined Field of type Date
...
udf_date_4
(optional)
...
Date
...
User Defined Field of type Date
...
expected_completion_date
(optional)
...
(optional)
...
(mandatory on conditions)
...
The assignment information of the activity. Assign to information is mandatory to be specified, unless if it is set automatically through ACR rules.
...
(optional)
...
The entities which are related with the activity
...
(optional)
...
The information related to the services to be provided with the activity
...
fields_set
(optional)
...
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
HTTP Method: POST
Request: Body:
Response:
|
POST activities/cancel
This method cancels an activity, which is not already completed or cancelled.
Tip |
---|
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
activity_identifier
(mandatory)
...
The identifier of the activity to be cancelled. The allowed activity identifier fields are the following:
...
status_identifier
(optional)
...
The status that will be set on the activity, after the cancellation. If not specified then the default status for cancelling activities of that type will be used. The allowed activity status identifiers are the following:
...
cancellation_reason_identifier
(mandatory)
...
The reason for cancelling the activity. The allowed activity cancellation reason identifiers are the following:
...
fields_set
(optional)
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
HTTP Method: POST
Request: Body:
Response:
|
POST activities/start_progress
This method sets an activity in progress. This method can be applied only on pending activities
Tip |
---|
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
activity_identifier
(mandatory)
...
The identifier of the activity that will be started. The allowed activity identifier fields are the following:
...
status_identifier
(optional)
...
The status that will be set on the activity, after starting the progress. If not specified then the default status for starting the progress for that type of activities will be used.The allowed activity status identifiers are the following:
...
fields_set
(optional)
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
HTTP Method: POST
Request: Body:
Response:
|
POST activities/complete
This method completes an activity, which is already in progress
Tip |
---|
Resource URL
Parameters
...
Name
...
Type
...
Description
...
token
...
String
...
The token retrieved from the login method
...
activity_identifier
(mandatory)
...
The identifier of the activity that will be completed. The allowed activity identifier fields are the following:
...
status_identifier
(optional)
...
The status that will be set on completing the activity. If not specified then the default status for completing an activity of that type will be used. The allowed activity status identifiers are the following:
...
fields_set
(optional)
...
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
...
Examples
Expand | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||
HTTP Method: POST
Request: Body:
Response:
|
...
Panel | ||||
---|---|---|---|---|
| ||||
|