List actions
GET/v2/actions
Fetches multiple action records. The records can be filtered, paged, and sorted according to the respective parameters. Only actions that are currently "in_progess" will be returned by this endpoint.
If the requester is not an admin, this endpoint will only return actions belonging to the requester. If the request is an admin, this endpoint will return actions for the entire team. Additionaly, an admin may use the user_guid parameter to request actions that belong to specific users on the team.
Request
Query Parameters
IDs of actions to fetch.
Fetch actions by step ID
Filter actions by type
Returns all matching records that are greater than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are greater than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Filters actions by the user's guid. Multiple user guids can be applied. The user must be a team admin to filter other users' actions
Filters actions by person_id. Multiple person ids can be applied
Filters actions by cadence_id. Multiple cadence ids can be applied
Filters actions by multitouch_group_id. Multiple multitouch group ids can be applied
Returns all matching records that are greater than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are greater than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than the provided iso8601 timestamp. The comparison is done using microsecond precision.
Returns all matching records that are less than or equal to the provided iso8601 timestamp. The comparison is done using microsecond precision.
Key to sort on, must be one of: created_at, updated_at. Defaults to updated_at
Direction to sort in, must be one of: ASC, DESC. Defaults to DESC
How many records to show per page in the range [1, 100]. Defaults to 25
The current page to fetch results from. Defaults to 1
Whether to include total_pages and total_count in the metadata. Defaults to false
Specifies whether the max limit of 10k records should be applied to pagination counts. Affects the total_count and total_pages data
Responses
- 200
Success
- application/json
- Schema
- Example (from schema)
Schema
ID of Action
Whether this step is due
Datetime of when the Action was created
Datetime of when the Action was last updated
The type of this action. Valid types are: email, phone, other. New types may be added in the future.
The current state of the person on the cadence. Possible values are:
in_progress: this action has not been completed
pending_activity: this action has been acted upon, but the action has not been completed. (i.e. the email is scheduled to send, but has not been delivered yet)
When action is due
ID of the multitouch group
action_details object
The type specific action details
user object
User assigned to action
person object
The subject of an action
cadence object
The cadence of an action
step object
The step of an action
task object
The task associated with an action
{
"id": 1,
"due": true,
"created_at": "2024-01-01T00:00:00.000000+00:00",
"updated_at": "2024-01-01T00:00:00.000000+00:00",
"type": "phone",
"status": "in_progress",
"due_on": "2024-01-01T00:00:00.000000+00:00",
"multitouch_group_id": 1,
"action_details": {
"id": 1,
"_href": "https://api.salesloft.com/v2/action_details/call_instructions/1"
},
"user": {
"id": 1,
"_href": "https://api.salesloft.com/v2/users/1"
},
"person": {
"id": 1,
"_href": "https://api.salesloft.com/v2/people/1"
},
"cadence": {
"id": 1,
"_href": "https://api.salesloft.com/v2/cadences/1"
},
"step": {
"id": 1,
"_href": "https://api.salesloft.com/v2/steps/1"
},
"task": {
"id": 1,
"_href": "https://api.salesloft.com/v2/tasks/1"
}
}