## ACTIVITY Activities are representations of events that happened in another system. They are a very flexible structure and can represent a wide variety of concepts from backend systems, e.g. CRMs to other social systems, e.g. a Twitter feed. Here's an example of what an activity will look like when it's rendered: ![Example Table](./images/activity-example.png) # Activity Definition Note: The items below are contained within an "activity" object, e.g. "activity":{...}, where the information with the ellipses is defined below.
Tile Property Description Required
action The verb that represent the kind of behavior that occurred in the activity, e.g. "updated".
Property Value required
name The name of the action Yes
description A textual explanation of the action. No
Yes
object The activity object contains the information about what happened on a specific item in the target system.
Property Value required
type The kind of object that is the target of the activity, e.g. website, opportunity. Yes
url A URL that represent the target object. It is recommended that this be a resolveable reference that can be used with REST. No
image A URL that will point to a icon used to represent the activity. No
title The title of the activity. No
description A textual explaination of the activity. No
externalID A unique identifier used for cross referencing activity objects between systems. No
#Example JSON 
	{  
	    "activity": {  
	        "action": {  
	            "name": "posted",  
	            "description": "Opportunity Updated"  
	        },  
	        "actor": {  
	            "name": "Actor Name",  
	            "email": "actor@email.com"  
	        },  
	        "object": {  
	            "type": "opportunity",  
	            "url": "http://saleforce.com/1234",  
	            "image": "http://saleforce.com/images/102x102",  
	            "title": "Big Co. Upgrade",  
	            "description": "Upgrade Opportunity for Big Co."  
	        },  
	        "externalID": "2048bbea-9254-4359-929b-784a0a5fcfff"  
	    }  
	}