Post an Activity with a Lead’s Email Address
This downloads our complete API collection, including all endpoints—not just this specific endpoint.
Post a custom activity on a lead by passing the lead’s email address.
Note:
- The supported DateTime format is UTC (YYYY-MM-DD HH:MM:SS).
- The API posts the activity to the lead that matches the email address you pass. If a lead with that email address doesn’t exist, a new lead gets created with the details you pass (First Name, Last Name, Phone Number and Email Address).
API URL
URL
POST
https://{host}/v2/ProspectActivity.svc/Create?accessKey=AccessKey&secretKey=SecretKey
Request
Content-Type: application/jsonJSON Body/Payload
{
"EmailAddress": "john.smith@acmeconsulting.co",
"ActivityEvent": 201,
"ActivityNote": "Note for the activity",
"ActivityDateTime": "2015-10-11 12:13:44",
"FirstName": "John",
"LastName" : "Smith",
"Phone" : "+919845098450",
"Fields": [
{
"SchemaName": "mx_Custom_1",
"Value": "123123123"
},
{
"SchemaName": "mx_Custom_2",
"Value": "123"
},
{
"SchemaName": "mx_Custom_3",
"Value": "3"
},
{
"SchemaName": "mx_Custom_4",
"Value": "4"
},
{
"SchemaName": "mx_Custom_5",
"Value": "2016-07-07 10:55:00"
},
{
"SchemaName": "mx_Custom_6",
"Value": "Value for Custom field"
},
{
"SchemaName": "mx_Custom_7",
"Value": "Value for Custom field"
},
{
"SchemaName": "mx_Custom_8",
"Value": "1"
},
{
"SchemaName": "mx_Custom_9",
"Value": "Value for Custom field"
},
{
"SchemaName": "mx_Custom_10",
"Value": ""
},
{
"SchemaName": "mx_Custom_11",
"Value": ""
},
{
"SchemaName": "mx_Custom_12",
"Value": ""
},
{
"SchemaName": "mx_Custom_13",
"Value": "Value for Custom field"
},
{
"SchemaName": "mx_Custom_14",
"Value": "Value for Custom field"
},
{
"SchemaName": "mx_Custom_15",
"Value": "asd"
}
]
}
Request Parameters
| Parameter | Description |
|---|---|
| EmailAddress | Email address of the lead. |
| ActivityEvent | Activity event code. |
| ActivityNote | Activity note. |
| ActivityDateTime | Activity date and time in yyyy-mm-dd hh:mm:ss format. |
| FirstName | First name of the lead. |
| LastName | Last name of the lead. |
| Phone | Phone number of the lead. |
Response
200 OK
Content-Type: application/json
{
"Status": "Success",
"Message": {
"Id": "c9f97054-5df5-11e5-981b-22000a9700b4"
}
}
HTTP Response Codes
| Code | Description |
|---|---|
| 200 OK | This is the status code for successful API call. |
| 401 Unauthorized | The API call was made with invalid access credentials. Check your AccessKey and SecretKey. |
| 400 Bad Request | The message body on the request is not as per API specification. Make sure that content type is set to “application/json” and the JSON body has correct attribute names and structure. |
| 404 Not Found | The API could not be found. Please check the API signature. |
| 429 Too Many Requests | API calls exceeded the limit of 25 in 5 second(s) |
| 500 Internal Server Error | The API called failed. There could be many reasons for it. Check the exception message to get more details. |
