Available from CRM.COM R9.0.0
GET webhook_requests/show
This method returns information related with a webhook request. A single webhook request is returned by each call
Resource URL
Parameters
Name | Type | Description | |||||||||
token | String | The token retrieved from the login method | |||||||||
webhook_request_identifier (mandatory) | Webhook Request Identifier | The identifier of the webhook request that should be returned as a result. The allowed webhook request 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
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved webhook request |
number | String | The number of the retrieved webhook request |
life_cycle_state | String | The life cycle state of the retrieved webhook request which can be SUCCESSFUL or REJECTED |
entity | String | The name of the entity that was communicated through the webhook request. The supported entities are the following:
|
entity_id | String | The ID of the entity that was communicated through the webhook request |
url | String | The URL that was used by the webhook to send the information |
authentication_code | String | The code that will be used for authentication purposes. The code is an HMAC (Hash Message Authentication Code) generated using the data JSON object and the secret key selected on the related definition |
fields_set | String | The fields set that was used by the webhook to send the information |
request | JSON Object | The request that was sent by the webhook |
response | JSON Object | The response that was received by the webhook |
error_code | String | The code of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
error_description | String | The description of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
webhook_definition | Webhook Definition Object | The webhook definition that was used to send the webhook request |
workflow_rule | Workflow Rule Object | The workflow rule that triggered the webhook request |
log_information | Log Information Object | The log information of the retrieved webhook request |
Referred Objects Response Data
Examples
GET webhook_requests/list
This method returns information related with webhook requests having specific attributes. Multiple webhook requests are returned by each call.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
webhook_definition_identifier (semi-optional) | Webhook Definition Identifier | The identifier of the webhook definition related with the webhook requests that should be returned as a result. The allowed webhook definition identifier fields are the following:
| ||||||||||||
workflow_rule_identifier (semi-optional) | Workflow Rule Identifier | The identifier of the workflow rule that triggered the webhook requests that should be returned as a result. The allowed workflow rule identifier fields are the following:
| ||||||||||||
entity (semi-optional) | String | The name of the entity related with the webhook requests that should be returned as a result. The supported entities are the following:
| ||||||||||||
entity_id (semi-optional) | String | The ID of the entity related with the webhook requests that should be returned as a result | ||||||||||||
url (optional) | String | The URL related with the webhook requests that should be returned as a result | ||||||||||||
life_cycle_state (optional) | String | The life cycle state of the webhook requests that should be returned as a result. The supported options are SUCCESSFUL or REJECTED | ||||||||||||
created_date (optional) | Date | The created date of the webhook requests that should be returned as a result. | ||||||||||||
fields_set | 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 at least one of the semi-optional parameters. Multiple of those parameters are allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved webhook request |
number | String | The number of the retrieved webhook request |
life_cycle_state | String | The life cycle state of the retrieved webhook request which can be SUCCESSFUL or REJECTED |
entity | String | The name of the entity that was communicated through the webhook request. The supported entities are the following:
|
entity_id | String | The ID of the entity that was communicated through the webhook request |
url | String | The URL that was used by the webhook to send the information |
authentication_code | String | The code that will be used for authentication purposes. The code is an HMAC (Hash Message Authentication Code) generated using the data JSON object and the secret key selected on the related definition |
fields_set | String | The fields set that was used by the webhook to send the information |
request | JSON Object | The request that was sent by the webhook |
response | JSON Object | The response that was received by the webhook |
error_code | String | The code of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
error_description | String | The description of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
webhook_definition | Webhook Definition Object | The webhook definition that was used to send the webhook request |
workflow_rule | Workflow Rule Object | The workflow rule that triggered the webhook request |
log_information | Log Information Object | The log information of the retrieved webhook request |
Referred Objects Response Data
Examples
POST webhook_requests/resend
This method is used to re-send rejected webhook requests. This method is applicable only on rejected webhook requests. A single webhook request can be re-send through this method
Resource URL
Parameters
Name | Type | Description | ||||||||||
token | String | The token retrieved from the login method | ||||||||||
webhook_request_identifier (mandatory) | Webhook Request Identifier | The identifier of the webhook request that should be send again. The allowed webhook request Identifier fields are the following:
Note that only rejected webhook requests can be specified in this method. |
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved webhook request |
number | String | The number of the retrieved webhook request |
life_cycle_state | String | The life cycle state of the retrieved webhook request which can be SUCCESSFUL or REJECTED |
entity | String | The name of the entity that was communicated through the webhook request. The supported entities are the following:
|
entity_id | String | The ID of the entity that was communicated through the webhook request |
url | String | The URL that was used by the webhook to send the information |
authentication_code | String | The code that will be used for authentication purposes. The code is an HMAC (Hash Message Authentication Code) generated using the data JSON object and the secret key selected on the related definition |
fields_set | String | The fields set that was used by the webhook to send the information |
request | JSON Object | The request that was sent by the webhook |
response | JSON Object | The response that was received by the webhook |
error_code | String | The code of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
error_description | String | The description of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
webhook_definition | Webhook Definition Object | The webhook definition that was used to send the webhook request |
workflow_rule | Workflow Rule Object | The workflow rule that triggered the webhook request |
log_information | Log Information Object | The log information of the retrieved webhook request |
Referred Objects Response Data
Examples
POST webhook_requests/delete
This method is used to delete successful or rejected webhook requests. A single webhook request can be deleted through this method
Resource URL
Parameters
Name | Type | Description | ||||||||||
token | String | The token retrieved from the login method | ||||||||||
webhook_request_identifier (mandatory) | Webhook Request Identifier | The identifier of the webhook request that should be deleted. The allowed webhook request Identifier fields are the following:
|
Restrictions
- It is mandatory to specify one of the semi-optional parameters. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved webhook request |
number | String | The number of the retrieved webhook request |
life_cycle_state | String | The life cycle state of the retrieved webhook request which can be SUCCESSFUL or REJECTED |
entity | String | The name of the entity that was communicated through the webhook request. The supported entities are the following:
|
entity_id | String | The ID of the entity that was communicated through the webhook request |
url | String | The URL that was used by the webhook to send the information |
authentication_code | String | The code that will be used for authentication purposes. The code is an HMAC (Hash Message Authentication Code) generated using the data JSON object and the secret key selected on the related definition |
fields_set | String | The fields set that was used by the webhook to send the information |
request | JSON Object | The request that was sent by the webhook |
response | JSON Object | The response that was received by the webhook |
error_code | String | The code of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
error_description | String | The description of the error that occurred while sending the webhook request. This is applicable only for rejected webhook request |
webhook_definition | Webhook Definition Object | The webhook definition that was used to send the webhook request |
workflow_rule | Workflow Rule Object | The workflow rule that triggered the webhook request |
log_information | Log Information Object | The log information of the retrieved webhook request |
Referred Objects Response Data
Examples
Webhook Request Data Description
Activities Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved activity |
number | String | The number of the retrieved activity |
description | String | The description of the retrieved activity |
notes | String | The notes of the retrieved activity |
life_cycle_state | String | The life cycle state of the retrieved activity which can be PENDING, IN PROGRESS, COMPLETED, CANCELLED |
start_date | Date | The date that the activity is created |
expected_completion_date | Date | The date that the activity is expected to be completed |
actual_completed_date | Date | The date that the activity is actually completed |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_string_9 | String | User Defined Field of type String |
udf_string_10 | String | User Defined Field of type String |
udf_string_11 | String | User Defined Field of type String |
udf_string_12 | String | User Defined Field of type String |
udf_string_13 | String | User Defined Field of type String |
udf_string_14 | String | User Defined Field of type String |
udf_string_15 | String | User Defined Field of type String |
udf_string_16 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_float_5 | Float | User Defined Field of type Float |
udf_float_6 | Float | User Defined Field of type Float |
udf_float_7 | Float | User Defined Field of type Float |
udf_float_8 | Float | User Defined Field of type Float |
udf_float_9 | Float | User Defined Field of type Float |
udf_float_10 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
udf_date_5 | Date | User Defined Field of type Date |
udf_date_6 | Date | User Defined Field of type Date |
udf_date_7 | Date | User Defined Field of type Date |
udf_date_8 | Date | User Defined Field of type Date |
udf_date_9 | Date | User Defined Field of type Date |
udf_date_10 | Date | User Defined Field of type Date |
assigned_to | Assign Object | The assignment information of the retrieved activity |
type | Activity type object | The type information of the retrieved activity |
status | Activity Status object | The status information of the retrieved activity |
category | Activity Category object | The categories information of the retrieved activity |
estimated_completion_time | Time Period Object | The time that is estimated to complete the activity, measured in MINUTES, HOURS, DAYS, WEEKS, YEARS From CRM.COM R17.0.0, YEARS is deprecated |
time_to_completion | Time Period Object | The time that is left up to the expected completion date |
time_overdue | Time Period Object | The time past the expected completion date |
performed_for | Performed for object | The entities which are related with the activity and can include Subscriptions, Jobs |
Contact Information object | The contact information related with the specified activity | |
cancellation_reason | Activities Cancellation Object | The reason that the activity was cancelled. This is applicable only if the activity is on a cancelled life cycle state |
owned_by_group | Group object | The group that is owning the activity Deprecated from CRM.COM R18.0.0 (replaced with owned_by_business_unit) |
owned_by_business_unit | Business Unit Object | The business unit that is owning the activity Available from CRM.COM R18.0.0 |
privacy_level | Privacy level object | The activity privacy level Deprecated from CRM.COM R18.0.0 |
Log Information Object | The log information related with the retrieved activity | |
services_to_be_provided_set | Services to be Provided object | The services that will be provided as part of the activity and the time that was spend on each one, measured in minutes, hours, days, weeks, months and years. |
Referred Objects Response Data