Smartgroups

Retrieve all Smart Groups

GETpeople/smartgroups

A Smart Group is a filtered list of users that has been saved in People CRM. This endpoint retrieves a list of all the Smart Groups associated with a specific project. It also returns the filters that have been applied to each Smart Group.

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder

Retrieve a Smart Group

GETpeople/smartgroups/{groupID}

Retrieves a single Smart Group by its groupID. The groupID is usually the lower-case name of the Smart Group. You can check the groupID by viewing the URL path that links you to the group in the People dashboard.

Path Parameters

groupID

StringRequired

The ID of the group

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups/{groupID}

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups/{groupID}?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder

Retrieve latest member count

GETpeople/smartgroups/{groupID}/count/latest

Retrieves the most recently sampled count of profiles in a Smart Group.

Path Parameters

groupID

StringRequired

The ID of the group

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups/{groupID}/count/latest

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups/{groupID}/count/latest?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder

Retrieve a list of people in Smart Group

GETpeople/smartgroups/{groupID}/people

Retrieves the list of people in a given Smart Group. This function is the equivalent of mapping the Smart Group's 'filters' property to the Search People method.

Using the query parameter you can search through this smartgroup

Path Parameters

groupID

StringRequired

The ID of the group

Query String Parameters

query

String

The query term you would you like to search for

fields

String

A comma delimited list of fields to be returned. (e.g. id,email). See Property Types for available options.

sort

StringDefault Value: last.seen:desc

Which property to sort by followed by :desc or :asc for direction. See Property Types for available options.

presenter

StringDefault Value: plain

Accepted values: plain, csv

Modifies the response data structure

limit

StringDefault Value: 0,10

The maximum number of results e.g. 10 to return with an optional offset e.g. 5,10. You can request a maximum of 250 results

dateFormat

String

The format that any date parameters will be returned in. This takes any value permitted by Moment.

Run in PostmanPostman is a useful developer tool for experimenting with and managing APIs that you work with

Definition

GET https://api.gosquared.com/people/v1/smartgroups/{groupID}/people

Example Request

curl "https://api.gosquared.com/people/v1/smartgroups/{groupID}/people?api_key=demo&site_token=GSN-106863-S" 

Live Responseundefined undefined

Your API Key is not authorised for this endpoint

Please fill in the required fields in the Query Builder