Groups allow you to segment your contacts so you can easily pull up a list of related contacts. When interacting with groups via the API, it's important to understand that there are two sets of functions. This page describes the group settings functions, which are used for managing the groups themselves. The functions on this page are rarely used, because once a group has been created, you normally don't need to mess with it. If you're trying to attach groups to contacts or see which contacts are in which groups, you should use the Group Memberships functions.
This function creates a new group in the CRM. Once a group has been created, you can create a group membership to attach the group to a contact.
The name of the group. Group names must be unique, so this can't match an existing group name.
Public
, Private
, Teams
Who should be able to see this group? By default, groups are private and can only be seen by the user who creates the group (Note: This doesn't mean the contacts in the group are private, just the group and group memberships are private). If you're an admin, you can make it public so all users can see the group (again, this won't impact contact permissions) or assign the group to another user. If you're using the teams feature, you can limit group access to only members of specific teams.
If you passed Team
as the sharing option, you must
also pass at least one TeamId so we know which team(s) can see this group.
This function edits an existing group.
The Id of the group you want to edit.
The name of the group. Group names must be unique, so this can't match an existing group name.
Public
, Private
, Teams
Who should be able to see this group? By default, groups are private and can only be seen by the user who creates the group (Note: This doesn't mean the contacts in the group are private, just the group and group memberships are private). If you're an admin, you can make it public so all users can see the group (again, this won't impact contact permissions) or assign the group to another user. If you're using the teams feature, you can limit group access to only members of specific teams.
If you passed Team
as the sharing option, you must
also pass at least one TeamId so we know which team(s) can see this group.
This function deletes an existing group.
The Id of the group you want to delete.
This function gets information about an individual group. Note: This doesn't get any information about the contacts in a group. For that, you'll want to get the group memberships.
The Id of the group you want to retrieve.
This function gets a list of all your groups. Note: This doesn't get any information about the contacts in each group. For that, you'll want to get the group memberships.
If set to true, will also return the number of contacts in each group. This will make the query significantly slower, so only use if you need the extra information.
How many results should be returned from a single API call? The max value is 10,000. If you need to return
more results, call this API function again, but increment the Page
parameter.
If there are more results than MaxNumberOfResults
, you can call this function again with an incremented
Page
value to get the next page of results. For example, if there are 700 results, but you're only requesting
500 at a time, you could call this function with Page=2 to get the remaining 200 results.