2026-09-11 View
Added search by endpoint name, path, description, and parameter name.
Added endpoint summaries showing the HTTP method, path, authentication, permissions, request encoding, and response type.
Improved parameter tables to distinguish required, optional, and conditional fields and show types, defaults, limits, repeated fields, and nullable response fields.
Added expandable success, error, and extended response examples with HTTP status codes and content types, including documentation for empty responses and ZIP downloads.
Added named request examples, including pagination and extended responses. The selected example language is now remembered across visits.
Added an editable request builder that generates cURL, Go, and JavaScript code, with support for omitted and empty values, repeated fields, file paths, additional parameters, and validation hints. The builder generates examples without sending API requests.
Corrected the group_id parameter in /gettopics examples and the question and answer fields in /updatepoll examples. Removed unsupported example parameters from /getfeed and /getpoll.
Clarified how omitted and empty values affect /updatewebhook, and documented the empty HTTP 200 response from /deletedatabaserow.
Improved the mobile layout, sidebar scrolling, code headers, expand/collapse controls, and code readability in dark mode.
2026-07-17 View
Added the `/updatetopic` endpoint to update a topic's subject and hashtags, moderation, locked and sticky states, and reply-to setting.
Added a machine-readable Groups.io API skill guide at `/api/SKILLS.md` .
2026-06-03 View
Added a new `sub_status_approved_awaiting_payment` value to the `status` field of the `member_info` object. It applies to paid-memberships groups where a member has been approved to join but has not yet completed payment. This is a non-breaking addition under the usual rule that clients must tolerate new enum values. If you determine whether someone is an active member by checking `status == sub_status_normal`, no change is needed. If instead you treat anyone who is not banned as a member (for example `status != sub_status_banned`), update your check to compare against `sub_status_normal` directly — otherwise an approved-but-unpaid applicant will be misclassified as a full member.
2026-04-02 View
Added `/getmessage` endpoint to fetch a single email.
2026-03-06 View
Fixed updating extra_member_data information in the `/updategroup` endpoint.
Added `/updateextramembercolumn` endpoint to make it easier to update a single value.
Added `/updateextramembercolumndef` endpoint to make it easier to update a single column definition.
2025-09-26 View
Changed the examples in the API documentation to use the new API Key authentication method.
2025-09-10 View
Added API Keys as a preferred way to authenticate API requests.
Added event endpoints to create, update and delete events.
Fixed some dark mode styling issues with the API docs.
2025-08-08 View
Added `accept_policies` required flag to the `/creategroup` and `/createsubgroup` endpoints, to conform to the UK's Online Safety Act.
2022-11-19 View
Added `/addfiles`, `/addfilelink`, and `/deletefile` endpoints.
2022-09-23 View
Improved the documentation for all of the database objects.
Fixed some issues with exporting of `extra_member_data_columns` in group objects and `extra_member_data` in member objects.
Added preliminary support for setting `extra_member_data` information via the `/updatemember` endpoint.
2022-07-15 View
Added `account_notify` field to the `member_info` struct, corresponding to the new Account notification setting.
2022-05-20 View
Fixed `end_date` documentation for `/getactivitylog` endpoint.
Erroneously, the `/getactivitylog` endpoint would not allow subgroups.
Changed `today` parameter to `last_24_hours` for the `/getactivitylog` endpoint.
2022-05-20 View
New `default_color` parameter for the `/updategroup` endpoint.
New `color` parameter for the `/updatemember` endpoint.
Changed color names to make them more consistent. All color names now start with `color_`. This affects color names that used to start with `tag_` and `column_color_`.
2021-09-10 View
Fixed `sub_group_access` documention to the `/update_group` endpoint documention.
Changed the `subgroup_access` field to `sub_group_access` on the group object to be consistent with other uses of the term.
Changed the `subgroupcategoryid` field to `sub_group_categoryid` on the group object to be consistent with other uses of the term.
Fix `sort_field` for `/searcharchives` endpoint.
2021-09-03 View
Added `description` parameter to the `/addphotos` endpoint.
2020-10-02 View
Added endpoints to get and manipulate pending messages, including `/getpendingmessages`, `/claimpendingmessage`, `/deletependingmessages`, `/rejectpendingmessages`, `/approvependingmessages`. NOTE: These endpoints
are still under development.
2020-08-07 View
Added `polls_visible` field to `perms` object.
2020-07-17 View
Added `trial_group` field to `group` object.
2020-07-10 View
Added `/getorg` endpoint.
Added `display_name`, `user_name`, `profile_photo_url`, `profile_privacy`, `email` fields to `album` object.
Changed `/registerdevice` endpoint to `/addpushsub`.
Added `/getpushsubs`, `/deletepushsub`, and `/deleteallpushsubs` endpoints.
Added `appleloginstart` and `appleloginfinal` endpoints to implement Apple Sign In.
Added `chat_notify`, `photo_notify`, `file_notify`, `wiki_notify`, `database_notify` fields to `memberinfo` object.
2020-06-12 View
Added `default_hashtag_view` field to the user object, which can be set using the `/updateuser` endpoint.
2020-05-22 View
Added `/getenterpriseinfo` endpoint.
2020-05-01 View
`/getevent` wasn't obeying the group calendar permissions setting.
2020-04-03 View
Added `/newgroupalias` and `/deletegroupalias` endpoints.
Added `/unbanmember` endpoint.
2020-03-27 View
Removed `bcc_me` parameter from `/postdraft` as that was unused.
Fixed bug when changing a subgroup's name using `/updategroup`.
`/newdraft` endpoint now supports `draft_type_post_to_sub` draft_type.
2020-03-20 View
Added `default_country` field to `Database Column` object.
Added `description` field to `Database Column` object.
Added `/getactivitylog` endpoint.
The docs incorrectly left off the `/get` prefix for the `subgroupcategories` endpoints.
2020-03-13 View
Fixed sort for `/getmembernotices` endpoint.
Added `email_address` field to `group` object.
2020-03-06 View
Most endpoints now support the `extended=true` parameter.
Endpoints `/unbounceuser`, `/deleteprofilephoto`, `/resendconfirmationemail` now require a POST request along with `csrf` token.
Added additional documentation around `extended=true` parameter.
Added `token` option to `/login` endpoint.
Added `bouncing` option for `type` parameter of `/getmembers` endpoint.
2020-02-28 View
Added `/searchmemberdirectory` endpoint.
Added `body` field to `message_search_result` object.
Removed the `invalid posterid` error from `/searcharchives` to allow people to search for messages from people who are no longer members of the group.
Added `default_hidden` field to the `Database Column` object.
Added `id_default_hidden` and `updated_default_hidden` fields to the `Database Table` object.
2020-02-21 View
Added "bad_request": "no space" errors to `/addphotos`, `/updatephoto` and `/addfiles` endpoints.
Added support for `extended=true` to all the drafts endpoints.
`/updatemember` can now return: "bad_request": "moderators cannot change role of owners" is returned if a non-owner attempts to change the `mod_status` field of an owner.
`/updatemember` can now return: "bad_request": "moderators cannot make members owners" is returned if a non-owner attempts to make a member an owner.
`/updatemember` can now return: "bad_request": "moderators cannot change owner subscription settings" is returned if a non-owner attempts to change an owner's subscription settings.
2020-02-07 View
Removed `create_sub_group` parameter from the `/creategroup` endpoint.
2020-01-31 View
Added `start_time` parameter to `/downloadarchives` endpoint.
Updated docs on `/updategroup` endpoint, adding some missing parameters.
New restriction on the `/updategroup` endpoint: a group that is not restricted cannot have a `members_visible` value of `group_view_members_subs`, unless it is a subgroup and the parent group is restricted.
2020-01-17 View
The `message` object now has an `attachments` array.
The docs for `/createhashtag` incorrectly stated that `description` was required.
`/downloadarchives` now supports `start_msg_num` parameter.
`/newdraft` now supports `draft_type_dm`.
Added `moderate_first_message` to `group` object.
2020-01-10 View
Changed `moderated` field to `moderation` in the `group` object.
2019-12-27 View
Added `plan` field to `group` object.
Added `nice_group_name`, `cover_photo_url`, `icon_url`, `subs_count`, `most_recent_message` fields to the `member_info` object.
Changed the sort options for the `/getsubs` endpoint and added the `set_home_page` parameter.
2019-12-20 View
First pass at `/getdatabaserows` endpoint.
Added `is_reply` field to `Message` object.
Added `/getdatabases` endpoint.
2019-12-13 View
Added `/mutehashtag`, `/unmutehashtag`, `/followhashtag`, and `/unfollowhashtag` endpoints.
2019-12-06 View
Added `create_hashtags` permission.
Added `/newhashtag`, `/updatehashtag`, `/deletehashtag` endpoints.
Added `reply`, `bcc_me` and `from_owner` parameters to the `/postdraft` endpoint.
Added `/authenticateloginlink` endpoint.
2019-11-29 View
Added `/sendloginlink`, `/resendconfirmationemail` and `/unbounceuser` endpoints.
Added `/getsubgroupsbycategory` endpoint.
2019-11-22 View
Added `/getsubgroupcategories` endpoint.
2019-11-15 View
Changed `search_result` object to `message_search_result`.
Added `/searchwikis` endpoint.
Added `/getbounceinfo` and `/getdeliveryinfo' endpoints.
Added `/getmessagehistory` endpoint.
Added optional `type` parameter to the `getmembernotices` endpoint.
Added `muted` and `followed` fields to `hashtag` object.
Added `/getsinglefeed` endpoint.
2019-11-08 View
Added `/getmemberdirectory` endpoint.
Added `sticky_wiki_page_id` field to the `group` object.
Added new `id` parameter to `/getwikiset` endpoint.
Added new `Types` section to the docs. Currently only lists the `action` enum.
Added `msg_num`, `subject`, `extra`, `extra2`, `extra_id` fields to `webhook_event` objects.
Changed all view_* permissions to be *_visible, to be consistent.
2019-11-01 View
New endpoints: `newpoll`, `updatepoll`, `getpoll`, `vote`
New endpoint: `registeruser`
New endpoints: `newwikipage`, `getwikipages`, `getwikipageset`.
2019-10-18 View
Added `signature` to `member_info` object.
2019-10-11 View
Added `open_donations_visible` to `perms` object.
Added `subgroups_visible` to `perms` object.
Added `hashtags_visible` to `perms` object.
Removed `view_archives` from `perms` object.
Changed `view_guidelines` to `guidelines_visible` in `perms` object.
Added `perms` field to `member_info` object.
Added new Subs array to `user` object.
The `member_info` object now only returns the fields that are set by the endpoint. Previously it returned all fields, regardless of whether the fields were set or not (some endpoints won't set all the fields based on permissions).
2019-10-04 View
Added new `webhook_event` and `webhook_subscription` objects. Webhook endpoints will be arriving shortly.
BUGFIX: The `/getmembers` API endpoint would return all members, including banned and pending members, if you didn't specify a `type`, instead of only returning normal members, which it should do.
Added `/getphoto` endpoint.
Added `display_name`, `user_name`, `profile_photo_url`, `profile_privacy`, `email` fields to the `photo` object.
Added `/reportcontent` endpoint.
2019-09-20 View
Added `/newmembernotice`, `/updatemembernotice`, `/deletemembernotice`, and `/getmembernotices` endpoints.
Added `/searchfiles` endpoint.
Added `/searchphotos` endpoint.
Added `/getfiledirectory` and `/getfile` endpoints.
Changed `snippet` field to `summary` in the `search_result` object for naming consistency.
Added `/testnotification` endpoint.
2019-09-20 View
Added `sort_field`, `second_order`, `query`, `sort_dir` fields to the pagination object.
Added `/registerdevice` endpoint for registering device tokens for notifications.
Added `exclude_aliases` flag to `/gethashtags` endpoint.
Added `/searcharchives` endpoint and related `search_result` and `search_results_list` objects.
Added `profile_photo_url`, `name` and `can_view_profile` fields to the `chat` object
Added `alias` field to `hashtag`.
Added `announce` flag to `/newchat` endpoint.
Added `addalbum`, `updatealbum`, `deletealbum`, `addphotos`, `updatephoto`, `deletephoto` endpoints.
2019-09-13 View
Changed `gallery_url` to `thumbnail_url` in attachments and photos.
Added `getalbums` and `getphotos` endpoints.
Changed `profile_photo_id` field in `member_info` to `profile_photo_url`.
Added `chatmembers` endpoint.
Added `updateprofile` endpoint.
Added `num_drafts` field to `member_info` object.
Added `updateprofilephoto` and `deleteprofilephoto` endpoints.
2019-09-06 View
Changed `profile_photo_id` to `profile_photo_url` in the User object.
2019-08-30 View
Added `googleloginstart` and `googleloginfinal` endpoints.
Added `facebookloginstart` and `facebookloginfinal` endpoints.
Added the `allow_sso_login` field to User object.
Added new `logout` endpoint to clear cookies.
2019-08-23 View
BREAKING CHANGE: All POST endpoints now require a `csrf` field. The new `csrf_token` in the `login` object should be used for this.
BREAKING CHANGE: API endpoints have been moved to https://groups.io/api/v1. The old endpoints will remain up for a month. Please update your code as soon as possible.
BREAKING CHANGE: The API is moving from Basic Authentication to a cookie based authentication. The existing Basic Auth tokens will continue to work until they expire. Please update your code as soon as possible.
The `chatdata` endpoint is now working.
Added `profile_privacy` and `version` fields to `chat_message`.
Changed `is_subscribed` field in `chat` to `chat_sub`.
Changed `profile_photo_id` field in `chat_message` to `profile_photo_url`.
Added `show_closed` parameter to the `getchats` endpoint.
2019-08-16 View
Changed `/getgroup` endpoint to require a `group_name` for groups that you are not subscribed to, for security.
Documentation change: The Objects section has been moved to the end of the docs.
The Group object now includes a Perms object if you are subscribed to the group.
Relaxed the requirement for having the `manage_group_settings` permission when accessing the `/getgroup` endpoint.
Added `/sendchatmsg` endpoint.
Added `/getchathistory` endpoint.
Added `group_name` and `nice_group_name` to the Event object.
2019-08-09 View
Renamed all instances of `sub_id` parameters to `member_info_id`. In all cases, `sub_id` will still be accepted to maintain backwards compatibility.
Removed API_KEY requirement for the /login endpoint.
Changed the /login endpoint from GET to POST.
Misc documentation improvements.
2019-07-19 View
New Chats section and endpoints.
New /getevent endpoint.
New /rsvp endpoint.
New /getgroupaliases endpoint.
Previously, the /getsubgroups endpoint would return group objects that represented group aliases. It now longer returns these.
In the /directadd endpoint, if a subgroupname or subgroupid is specified that points to a group alias, the pointed to group will be used instead.
Misc documentation improvements.
2019-07-05 View
New Drafts section and endpoints.
Misc documentation improvements.
2019-06-21 View
2019-06-10 View
Changed the format of the past member object.
2019-06-07 View
New /getpastmembers endpoint.
Various new object members.
2018-11-09 View
New subscription_plus field: nice_group_name.
New /gettopics parameter: `extended`.
2018-11-02 View
New subscription_plus fields: group_alias, org_id, org_domain.
Additional error codes for the /v1/login endpoint.
Working /gettopics endpoint, and start of documentation for the "topic" and "hashtag" objects.
2018-09-19 View
New subscription post_status values: sub_poststatus_modfirstmessage, sub_poststatus_modstartedtopics.
2018-08-29 View
New group field: handle_virus.
2018-08-10 View
Changed group field: restrict_create_hash_tags is now hash_tag_permissions.
2018-07-16 View
New group field: subgroup_category_id.
2018-07-10 View
New group fields: allow_reposts, min_days_between_reposts, max_number_of_reposts.
2018-06-21 View
Changed user field: time_pref now refers to how times should be formatted.
New user field: date_pref.
New group fields: default_date_pref, default_time_pref.
2018-06-12 View
New group fields: seperate_footers, allow_downloads.
New permissions fields: download_archives, download_entire_group
2018-02-26 View
The /updatemember endpoint has been updated with the ability to set a member's signature and email address (if a premium group).
Added group_attachments_moderated as an option for a group's handle_attachments field.
Added group_id to the errors section of the direct_add object.
Added subscription permission `sub_perm_viewmembers`.
Added `lock_group` option to the /updategroup endpoint.
2018-02-02 View
The group object now includes the new `fig_leaf` attribute.
2018-01-11 View
The group object now returns various counts, including subs, pending subs, pending messages, threads and messages.
The group object now returns the new default timezone value.
2017-10-23 View
Working /creategroup endpoint.
Changed the "invalid groupname" error from /createsubgroup to "invalid group_name" for consistency.
/createsubgroup now takes subscription options.
2017-10-06 View
Working /bulkremovemembers endpoint.
/getgroup can now take a group_name parameter instead of a group_id parameter.
2017-09-01 View
Working /downloadarchives endpoint.
2017-08-24 View
Working /updatesub endpoint.
Working /deletesub endpoint.
Improvements in doc consistency.
2017-08-21 View
Working /deletegroup endpoint.
2017-08-18 View
Pointer to this new changelog.
Working /createsubgroup endpoint.
2017-08-17 View
