POST customer_events/social_media/create
Deprecated from CRM.COM R15.0.0 onwards. This functionality will be provided through achievement customer events
This method is used to create a social media customer event in a posted life cycle state
Resource URL
Parameters
Name | Type | Description | |||||||||||||||||||||||||||
token | String | The token retrieved from the login method | |||||||||||||||||||||||||||
accounts_receivable_identifier (semi-optional) | Accounts receivable Identifier | The related accounts receivable. The allowed accounts receivable identifier fields are the following:
| |||||||||||||||||||||||||||
rewards_participant_identifier (semi-optional) | Rewards Participant Identifier | The related rewards participant. The allowed rewards participant identifier fields are the following:
| |||||||||||||||||||||||||||
classification_identifier (optional) | Customer Event Classification Identifier | The classification of the customer event. The allowed customer event classification identifier fields are the following:
| |||||||||||||||||||||||||||
performed_by_unit_identifier (mandatory) | Unit Identifier | The unit that initiated the customer event. The allowed unit identifier fields are the following:
| |||||||||||||||||||||||||||
performed_on (mandatory) | Date | The date that the customer event was actually performed | |||||||||||||||||||||||||||
description (optional) | String | A description of the customer event | |||||||||||||||||||||||||||
process_immediately (optional) | boolean | Defines if the customer event was processed immediately by various business processes or not | |||||||||||||||||||||||||||
social_media (mandatory) | String | The social media related with the customer event, which can be one of the following: FACEBOOK | |||||||||||||||||||||||||||
profile (mandatory) | String | The social media profile related with the customer event | |||||||||||||||||||||||||||
action (mandatory) | String | The social media action that was performed. The following actions per social media are supported (if the social media is set to Facebook) LIKE | |||||||||||||||||||||||||||
external_system (optional) | String | Defines the third party system that generates the customer event Available from CRM.COM R10.0.0 | |||||||||||||||||||||||||||
external_system_reference_number (optional) | String | Defines the unique reference number of the external system for this customer event Available from CRM.COM R10.1.0 | |||||||||||||||||||||||||||
udf_string_1 (optional) | String | User Defined Field of type String | |||||||||||||||||||||||||||
udf_string_2 (optional) | String | User Defined Field of type String | |||||||||||||||||||||||||||
udf_string_3 (optional) | String | User Defined Field of type String | |||||||||||||||||||||||||||
udf_string_4 (optional) | String | User Defined Field of type String | |||||||||||||||||||||||||||
udf_string_5 (optional) | String | User Defined Field of type String | |||||||||||||||||||||||||||
udf_string_6 (optional) | String | User Defined Field of type String | |||||||||||||||||||||||||||
udf_string_7 (optional) | String | User Defined Field of type String | |||||||||||||||||||||||||||
udf_string_8 (optional) | String | 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 | |||||||||||||||||||||||||||
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 Available from CRM.COM R10.0.0 |
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 social media customer event |
number | String | The number of the retrieved social media customer event |
type | String | The type of the retrieved social media customer event which in this case is set to SOCIAL_MEDIA |
life_cycle_state | String | The life cycle state of the customer event which can be POSTED or CANCELLED |
performed_on | Date | The date that the customer event was actually performed |
description | String | A description of the customer event |
process_immediately | boolean | Defines if the customer event was processed immediately by various business processes or not |
social_media | String | The social media related with the customer event, which can be one of the following: FACEBOOK |
profile | String | The social media profile related with the customer event |
action | String | The social media action that was performed. The following actions per social media are supported (if the social media is set to Facebook) LIKE |
external_system | String | Defines the third party system that generated the customer event Available from CRM.COM R10.0.0 |
external_system_reference_number | String | Defines the unique reference number of the customer event in the external system Available from CRM.COM R10.1.0 |
total_awarded_amount | Number | The total amount that was awarded for the customer event Available from CRM.COM R13.1.0 |
total_awarded_alternative_amount | Number | The total amount that was awarded for the customer event in the alternative currency. Available from CRM.COM R14.2.0 |
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_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_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 |
classification | Customer Event Classification Object | The classification of the customer event |
accounts_receivable | Accounts receivable Object | The related accounts receivable |
performed_by_unit | Unit Object | The unit that initiated the customer event |
Log Information Object | The log information related with the retrieved invoice | |
award_reward_transactions_set | Set of Award Reward Transaction Object | The award reward transactions that were created as a result of the social media customer event |
Referred Objects Response Data