Available from CRM.COM R9.0.0
This method returns information related with alerts having specific attributes. Multiple alerts are returned by each call.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
| recipient_identifier (semi-optional) | Recipient Identifier | The identifier of the recipient related with the alerts that should be returned as a result. The allowed recipient identifier fields are the following:
| ||||||||||||
alert_definition_identifier (semi-optional) | Alert Definition Identifier | The identifier of the alert definition related with the alerts that should be returned as a result. The allowed alert definition identifier fields are the following:
| ||||||||||||
workflow_rule_identifier (semi-optional) | Workflow Rule Identifier | The identifier of the workflow rule that triggered the alerts 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 alerts that should be returned as a result. The supported entities are the following:
REWARDOFFERS entity is available from CRM.COM R11.0.0 | ||||||||||||
entity_id (semi-optional) | String | The ID of the entity related with the alerts that should be returned as a result | ||||||||||||
recipient_email_address (optional) | String | The email address of the recipient related with the alerts that should be returned as a result | ||||||||||||
recipient_phone_number (optional) | String | The phone number of the recipient related with the alerts that should be returned as a result | ||||||||||||
life_cycle_state (optional) | String | The life cycle state of the alerts that should be returned as a result. The supported options are SUCCESSFUL or REJECTED | ||||||||||||
created_date (optional) | Date | The created date of the alerts that should be returned as a result. | ||||||||||||
number_of_results (optional) | Number | The number of results that can be retrieved through each call Available from CRM.COM R13.0.0 | ||||||||||||
offset (optional) | Number | 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 Available from CRM.COM R13.0.0 | ||||||||||||
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. Only one of those parameters is allowed to be specified.
Response Data
Name | Type | Description |
|---|---|---|
id | String | The ID of the retrieved alert |
number | String | The number of the retrieved alert |
| life_cycle_state | String | The life cycle state of the retrieved alert which can be SUCCESSFUL or REJECTED |
| type | String | The type of the retrieved alert which can be EMAIL or SMS |
| entity | String | The name of the entity that was communicated through the alert. The supported entities are the following:
|
| entity_id | String | The ID of the entity that was communicated through the alert |
| subject | String | The subject of the retrieved alert. This is applicable only if the type is EMAIL |
| content | String | The content of the retrieved alert |
| recipient_email_address | String | The email address of the recipient. This is applicable only if the type is EMAIL |
| recipient_phone_number | Number | The phone number of the recipient. This is applicable only if the type is SMS |
| error_code | String | The code of the error that occurred while sending the alert. This is applicable only for rejected alerts |
| error_description | String | The description of the error that occurred while sending the alert. This is applicable only for rejected alerts |
| recipient | User Object | The recipient user of the retrieved alert |
| alert_definition | Alert Definition Object | The alert definition that was used to send the alert |
| workflow_rule | Workflow Rule Object | The workflow rule that triggered the alert |
| log_information | Log Information Object | The log information of the retrieved alert |
Referred Objects Response Data
Examples
HTTP Method: GET
Request:
Response:
{
"status":
{
"message": "",
"description": "",
"code": "OK"
},
"data":
[
{
"entity": "ACTIVITIES",
"number": "4",
"recipient_email_address": "m_ioannou@crm.com",
"subject": "Test Alert ACT000366 ",
"log_information":
{
"updated_date": "2015-11-03T12:08:04",
"created_date": "2015-11-03T12:08:03",
"created_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"updated_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
},
"updated_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
}
},
"life_cycle_state": "SUCCESSFUL",
"alert_definition":
{
"life_cycle_state": "EFFECTIVE",
"type": "EMAIL",
"id": "26D38E26DE6647529FDCCBFD0F2F7C48",
"name": "Send Alert To created By User",
"alternative_code": "CREATED_BY_USER"
},
"entity_id": "78F2C4952DF14A38B7F789393AC84EDC",
"content": " Mr Ioannou132 Marios your activity with number ACT000366 was created
with sub location
with job location
with lead ",
"recipient": null,
"type": "EMAIL",
"id": "DDB095659F0A4354BA4DF17F1BC21232",
"workflow_rule":
{
"life_cycle_state": "EFFECTIVE",
"id": "5DB96A77C25B4D19A65C4515D4E0D394",
"name": "Workflow Rule Activity On Update",
"alternative_code": "Upd_Act"
}
},
{
"entity": "ACTIVITIES",
"number": "5",
"recipient_email_address": "sakkascy1986@hotmail.com",
"subject": "Test Alert ACT000355 ",
"log_information":
{
"updated_date": "2015-11-03T15:00:44",
"created_date": "2015-11-03T15:00:43",
"created_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"updated_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
},
"updated_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
}
},
"life_cycle_state": "SUCCESSFUL",
"alert_definition":
{
"life_cycle_state": "EFFECTIVE",
"type": "EMAIL",
"id": "26D38E26DE6647529FDCCBFD0F2F7C48",
"name": "Send Alert To created By User",
"alternative_code": "CREATED_BY_USER"
},
"entity_id": "7FB01C80AF6D47B0A9740E0A9A10C2D0",
"content": " Mr Ioannou130 Marios your activity with number ACT000355 was created
with sub location
with job location
with lead ",
"recipient":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
},
"type": "EMAIL",
"id": "B59339D5C4DE47569D71FD077FE26325",
"workflow_rule":
{
"life_cycle_state": "EFFECTIVE",
"id": "5DB96A77C25B4D19A65C4515D4E0D394",
"name": "Workflow Rule Activity On Update",
"alternative_code": "Upd_Act"
}
},
{
"entity": "ACTIVITIES",
"number": "6",
"recipient_email_address": "m_ioannou@crm.com",
"subject": "Test Alert ACT000366 ",
"log_information":
{
"updated_date": "2015-11-03T16:43:01",
"created_date": "2015-11-03T16:42:31",
"created_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"updated_by_unit":
{
"community_name": "Internal Community",
"id": "48305F8849E3C18B227C5BE3A27BA6DF",
"name": "Admin Unit",
"group_name": "Main Group",
"description": "r1 Test Description for resource request tab.Test Description for resource request tab.",
"alternative_code": "MG"
},
"created_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
},
"updated_by_user":
{
"person_name": "MPAdministrator",
"username": "MPAdministrator",
"id": "1",
"email": "sakkascy1986@hotmail.com"
}
},
"life_cycle_state": "SUCCESSFUL",
"alert_definition":
{
"life_cycle_state": "EFFECTIVE",
"type": "EMAIL",
"id": "26D38E26DE6647529FDCCBFD0F2F7C48",
"name": "Send Alert To created By User",
"alternative_code": "CREATED_BY_USER"
},
"entity_id": "78F2C4952DF14A38B7F789393AC84EDC",
"content": " Mr Ioannou132 Marios your activity with number ACT000366 was created
with sub location
with job location
with lead ",
"recipient":
{
"person_name": "m_ioannou",
"username": "m_ioannou",
"id": "C5D6D95C71C4484F9168A5444FC928EF"
"email": "m_ioannou@crm.com"
},
"type": "EMAIL",
"id": "761E70B2CF7E4E3F9DD4140A98023536",
"workflow_rule":
{
"life_cycle_state": "EFFECTIVE",
"id": "5DB96A77C25B4D19A65C4515D4E0D394",
"name": "Workflow Rule Activity On Update",
"alternative_code": "Upd_Act"
}
},
....
]
}