The Groups.io API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients. JSON is returned by many API responses, when appropriate, including errors.

Note: The API is under active development. Items marked [NI] mean they are not yet implemented.

There is a group to discuss the API. If you have questions about the API or suggestions for improvements of the API or the docs, please post them there.

API Endpoints

The endpoint for accessing all groups a person is subscribed to is groups.io/api. If a person is subscribed to one or more enterprise groups, accessing just those groups can be done through the enterprise domain.

Versioning And Change Log

NOTE During development, we sometimes need to make backwards incompatible changes. If this happens during development, we will not be changing API versions.

View the changelog to see changes between different versions.

What changes does Groups.io consider to be “backwards-compatible”?

Adding new API resources.
Adding new optional request parameters to existing API methods.
Adding new properties to existing API responses.
Changing the order of properties in existing API responses.
Changing the length of object IDs or other opaque strings.
You can safely assume object IDs we generate will never exceed 255 characters, but you should be able to handle IDs of up to that length. If for example you’re using MySQL, you should store IDs in a VARCHAR(255) COLLATE utf8_bin column (the COLLATE configuration ensures case-sensitivity in lookups). Adding new event types.

Success

Groups.io uses conventional HTTP response codes to indicate the success or failure of an API request. HTTP response code 200 indicates success and HTTP response code 400 indicates an error. In addition, some endpoints need to return additional information on success. In these instances, a success object is returned with the additional information. This object is returned with the HTTP 200 response code.

Response Attributes

object string, value is "success"	String representing the object’s type. Objects of the same type share the same value.
extra	Extra information, endpoint specific.

Example Success Response

    {
      "object": "success",
      "extra": "pending post"
    }

Errors

Groups.io uses conventional HTTP response codes to indicate the success or failure of an API request. HTTP response code 200 indicates success and HTTP response code 400 indicates an error. In addition, when there is an error, an error object is returned, containing details of the error.

All API calls return an error object when there is an error, in addition to returning an HTTP 400 error code. Errors specific to API calls are listed with each API call. General errors, that can happen with any API call, are listed in this section.

Response Attributes

object string, value is "error"	String representing the object’s type. Objects of the same type share the same value.
type	The type of error returned.
extra	Extra information, error specific.

General Errors

unauthorized_error	Incorrect email address or password.
bad_request	Incorrect parameters passed in. For example, a group id that doesn't exist.
authentication	Failure to properly authenticate yourself in the request.
expired	The supplied authentication token is too old.
rate_limit	Too many requests hit the API too quickly.
inadequate_permissions	You do not have permission to execute the specific API call.
invalid_value	When a value is unrecognized. The `extra` field will be set to the name of the field with the invalid value.
server	There was a problem with the server. Please try again later.
bad_csrf	The endpoint required a valid `csrf` parameter. The parameter was either missing or incorrect.

HTTP status code summary

200 OK	Everything worked as expected.
400 Bad Request	The request was unacceptable, often due to missing a required parameter.
429 Too Many Requests	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests.

Example Error Response

    {
      "object": "error",
      "type": "unauthorized",
      "extra": ""
    }

Extended Return Information

Many endpoints support the extended=true parameter. When this is specified, additional information is returned from the endpoint. The default return for an endpoint is a JSON object, as specified in the documentation. When the extended=true parameter is set, instead a two element JSON array is returned. One element of the array is the original return object. The second element is a User Object.

Pagination

Some API resources support pagination. These calls take at least these query parameters: limit, page_token, sort_field, sort_dir. Their responses use the list response format defined below.

Groups.io utilizes cursor-based pagination via the page_token and next_page_token parameters. For the first call to an endpoint that supports paging, do not include the page_token parameter. The response will include a next_page_token number. To fetch the next page of results, call the endpoint with page_token set to the next_page_token number.

Query Parameters

limit optional number, default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be 'asc' or 'desc'.

List Response Format

object string, value is "list"	String representing the object’s type. Objects of the same type share the same value.
total_count number	The total number of items.
start_item number	The index of the first item returned.
end_item number	The index of the last item returned.
has_more boolean	Whether or not there are more elements available after this set. If `false`, this set comprises the end of the list.
next_page_token opaque	To fetch the next page, set the `page_token` value to this number. This should be considered an opaque value.
data array	An array containing the actual response elements, paginated by any request parameters.

Example Response

{
  "object": "list",
  "total_count": 2,
  "start_item": 1,
  "end_item": 2,
  "has_more": false,
  "next_page_token": 0,
  "data": [
    {
      "id": 701,
      "object": "subscription",
      "created": "2017-08-15T13:58:22.618029196-07:00",
      "updated": "2017-08-15T13:58:22.618029196-07:00",
      "user_id": 147,
      "group_id": 4,
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_normal",
      "email_delivery": "email_delivery_single",
      "message_selection": "message_selection_all",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_small",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_none",
      "pending_msg_notify": "sub_notify_email",
      "pending_sub_notify": "sub_notify_email",
      "sub_notify": "sub_notify_email",
      "storage_notify": "sub_notify_email",
      "sub_group_notify": "sub_notify_email",
      "message_report_notify": "sub_notify_email",
      "mod_permissions": "",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "email": "john@smith.com",
      "user_status": "user_status_confirmed",
      "user_name": "",
      "timezone": "",
      "full_name": "John Smith",
      "about_me": "",
      "about_format": "about_html",
      "location": "",
      "website": "",
      "profile_photo_id": "",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "moderator_notes": "",
      "moderator_notes_updated": "1969-12-31T16:00:00-08:00",
      "use_signature": false,
      "use_signature_email": false
    },
    {
      "id": 702,
      "object": "subscription",
      "created": "2017-08-15T13:58:22.618029196-07:00",
      "updated": "2017-08-15T13:58:22.618029196-07:00",
      "user_id": 147,
      "group_id": 4,
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_normal",
      "email_delivery": "email_delivery_single",
      "message_selection": "message_selection_all",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_small",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_none",
      "pending_msg_notify": "sub_notify_email",
      "pending_sub_notify": "sub_notify_email",
      "sub_notify": "sub_notify_email",
      "storage_notify": "sub_notify_email",
      "sub_group_notify": "sub_notify_email",
      "message_report_notify": "sub_notify_email",
      "mod_permissions": "",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "email": "john@smith.com",
      "user_status": "user_status_confirmed",
      "user_name": "",
      "timezone": "",
      "full_name": "John Smith",
      "about_me": "",
      "about_format": "about_html",
      "location": "",
      "website": "",
      "profile_photo_id": "",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "moderator_notes": "",
      "moderator_notes_updated": "1969-12-31T16:00:00-08:00",
      "use_signature": false,
      "use_signature_email": false
    }
  ]
}

Libraries

The following are unofficial libraries.

JAVA	github.com/lake54/groupsio-api-java

Authentication

Authentication to the API is performed via one of three methods:

API Keys (Recommended)

The recommended method is to use API keys with the Authorization header, similar to Stripe and OpenAI:

curl "https://groups.io/api/v1/groups" \
  -H "Authorization: Bearer YOUR_API_KEY_HERE"

API keys can be created and managed in your account settings at https://groups.io/settings/apikeys. API keys:

Do not require calling /login first
Are stateless - each request is authenticated independently
Bypass two-factor authentication requirements
Do not require CSRF tokens
Can be revoked without changing your password

Session-Based Authentication

Alternatively, authentication can be performed via HTTP cookies using cookies set from the login API call, which is the default, or via HTTP Basic Auth, using a token received from the login API call when passing in the token parameter. Note, some endpoints, like /facebooklogin, /googlelogin and the chat endpoints require or institute cookie login. All curl examples in the documentation assume cookie authentication unless otherwise noted.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail.

Get Activity Log

Get activity log entries. Entries are returned using the pagination request and object format.

Permissions Needed

You must have the view_activity permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are "id" and "created".
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
filter_by optional string	Type of log to filter by, can be: `member`, `message`, `mod`, `pay`.
restrict_date optional string	Time period to restrict results by, can be: `last_24_hours`, `last_week`, `last_30_days`, `before`, `after`, `between`.
start_date optional string	Start time of the time period specified by `restrict_date` values of `after`, `between`.
end_date optional string	End time of the time period specified by `restrict_date` values of `before`, `between`.
action optional string	Restrict results to a single activity type.
member_info_id optional number	Restrict results to the member.
past_member_info_id optional number	Restrict results to the past member.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a Activity Log list object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid filter_by" is returned if the filter_by value is invalid.
"bad_request"	"invalid restrict_date" is returned if the restrict_date value is invalid.
"bad_request"	"invalid action" is returned if the action value is invalid.
"bad_request"	"invalid start_date" is returned if the start_date value is invalid.
"bad_request"	"invalid end_date" is returned if the end_date value is invalid.

GET /api/v1/getactivitylog
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getactivitylog?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getactivitylog?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getactivitylog');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "activity_log",
       "created": "2020-09-02T00:51:00-07:00",
       "group_id": 8658933,
       "entry": "Integration \"testintegration\" sent  special notice #0",
       "via": "via_robot"
     },
     {
       "id": 10192753,
       "object": "activity_log",
       "created": "2020-08-30T23:30:00-07:00",
       "group_id": 8658933,
       "entry": "Integration \"testintegration\" sent  special notice #1",
       "via": "via_robot"
     },
     {
       "id": 122478329,
       "object": "activity_log",
       "created": "2020-10-01T15:33:00-07:00",
       "group_id": 8658933,
       "entry": "Integration \"testintegration\" sent  special notice #2",
       "via": "via_robot"
     }
   ]
}

View Activity Log List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

These endpoints deal with the message archives. The archives consist of messages, which are grouped into topics.

Get Topics

Get a group's topics or a user's topics. A topic represents one or more messages in a group. Topics are returned using the pagination request and object format.

Permissions Needed

You must have the archives_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` can be specified. If neither is specified, a user's set of groups is used.
group_name required string	Name of the group. Either `group_id` or `group_name` can be specified. If neither is specified, a user's set of groups is used.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a topic list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

No additional errors

GET /api/v1/gettopics
cURL
Go
JavaScript

curl "https://groups.io/api/v1/gettopics?groupid=2" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/gettopics?groupid=2", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/gettopics');
    url.searchParams.append('groupid', '2');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "topic",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "group_id": 8658933,
       "group_subject_tag": "[StrategyHub]",
       "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
       "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
       "name": "Elenor Schaefer",
       "profile_photo_url": "",
       "num_messages": 10,
       "is_sticky": false,
       "is_moderated": false,
       "is_closed": false,
       "has_attachments": false,
       "reply_to": "thread_reply_group_default",
       "most_recent_message": "2020-09-13T23:35:00-07:00",
       "hashtags": null
     },
     {
       "id": 40360814,
       "object": "topic",
       "created": "2020-08-30T21:35:00-07:00",
       "updated": "2023-05-02T01:56:00-07:00",
       "group_id": 8658933,
       "group_subject_tag": "[StrategyHub]",
       "subject": "Some instance inquire ourselves his laugh string several accordingly kindness bit stand.",
       "summary": "Woman just poised they enough thing homework each clothing other. Cry obediently refill do differs yearly those woman pen today. As now ourselves first for without what might any where. As out me were Norwegian significant his do mob notice. Lastly theirs hotel one calm that later does point throw.",
       "name": "Albina Bernhard",
       "profile_photo_url": "",
       "num_messages": 29,
       "is_sticky": false,
       "is_moderated": false,
       "is_closed": false,
       "has_attachments": false,
       "reply_to": "thread_reply_group_default",
       "most_recent_message": "2020-09-08T16:42:00-07:00",
       "hashtags": null
     },
     {
       "id": 135780324,
       "object": "topic",
       "created": "2020-09-24T13:22:00-07:00",
       "updated": "2022-10-24T22:40:00-07:00",
       "group_id": 8658933,
       "group_subject_tag": "[StrategyHub]",
       "subject": "For previously as of along nobody back hers numerous would our bra.",
       "summary": "Yours union Bangladeshi Bahamian now wiggle should our example eye. Woman in religion am collapse regiment in were choir troop. Speed throw year work let bunch one choir those horror. Would is so team disregard completely decidedly which exaltation decidedly. Think niche annoyance yesterday hence as him his this one.",
       "name": "Elmore Prosacco",
       "profile_photo_url": "",
       "num_messages": 29,
       "is_sticky": false,
       "is_moderated": false,
       "is_closed": false,
       "has_attachments": false,
       "reply_to": "thread_reply_group_default",
       "most_recent_message": "2020-09-15T14:17:00-07:00",
       "hashtags": null
     }
   ]
}

View Topic List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Topic

Get the messages within a specified topic. Messages are returned using the pagination request and object format.

Permissions Needed

You must have the archives_visible permission to use this call with a group.

Query Parameters

topic_id required number	ID of the topic to return.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or .
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the messagelist object. Returns an error if parameters are invalid (e.g. specifying an invalid topic_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid topic_id" is returned if the topic id is missing or invalid.

GET /api/v1/gettopic
cURL
Go
JavaScript

curl "https://groups.io/api/v1/gettopic?topic_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/gettopic?topic_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/gettopic');
    url.searchParams.append('topic_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 64,
 "start_item": 29,
 "end_item": 34,
 "has_more": false,
 "next_page_token": 70,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "group_perms": 
   {
      "object": "perms",
      "archives_visible": true,
      "polls_visible": true,
      "members_visible": true,
      "chat_visible": true,
      "calendar_visible": true,
      "files_visible": true,
      "database_visible": true,
      "photos_visible": true,
      "wiki_visible": true,
      "member_directory_visible": true,
      "hashtags_visible": true,
      "guidelines_visible": true,
      "subgroups_visible": true,
      "open_donations_visible": true,
      "sponsor_visible": true,
      "manage_subgroups": true,
      "ask_visible": true,
      "delete_group": true,
      "download_archives": true,
      "download_entire_group": true,
      "download_members": true,
      "view_activity": true,
      "create_hashtags": true,
      "manage_hashtags": true,
      "manage_integrations": true,
      "manage_group_settings": true,
      "make_moderator": true,
      "manage_member_subscription_options": true,
      "manage_pending_members": true,
      "remove_members": true,
      "ban_members": true,
      "manage_group_billing": true,
      "manage_group_payments": true,
      "edit_archives": true,
      "manage_pending_messages": true,
      "invite_members": true,
      "can_post": true,
      "can_reply": true,
      "can_vote": true,
      "manage_polls": true,
      "manage_photos": true,
      "manage_members": true,
      "manage_calendar": true,
      "manage_chats": true,
      "view_member_directory": true,
      "manage_files": true,
      "manage_wiki": true,
      "manage_subscription": true,
      "public_page": true,
      "sub_page": true,
      "mod_page": true,
      "can_ask": true
   },
 "group": 
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   },
 "cover_photo_url": "",
 "sub_data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
 "topic": 
   {
      "id": 52691321,
      "object": "topic",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "group_id": 8658933,
      "group_subject_tag": "[StrategyHub]",
      "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
      "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
      "name": "Elenor Schaefer",
      "profile_photo_url": "",
      "num_messages": 22,
      "is_sticky": false,
      "is_moderated": false,
      "is_closed": false,
      "has_attachments": false,
      "reply_to": "thread_reply_group_default",
      "most_recent_message": "2020-09-29T17:03:00-07:00",
      "hashtags": null
   },
 "data": [
   {
    "id": 61,
    "object": "message",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 41,
    "group_id": 96,
    "topic_id": 71,
    "body": "",
    "quoted": "",
    "remainder": "",
    "snippet": "",
    "subject": "",
    "subject_with_tags": "",
    "name": "",
    "profile_photo_url": "",
    "is_plain_text": false,
    "msg_num": 88,
    "is_reply": false,
    "has_liked": false,
    "num_likes": 32,
    "is_closed": false,
    "is_moderated": false,
    "reply_to": "group_reply_only_to_sender",
    "can_repost": false,
    "hashtags": [
      {
         "id": 541,
         "object": "hashtag",
         "created": "2020-09-17T11:22:00-07:00",
         "group_id": 1188,
         "name": "Karl",
         "mods_only_post": false,
         "mods_only_replies": false,
         "no_email": false,
         "moderated": false,
         "special": true,
         "replies_unmoderated": false,
         "locked": true,
         "until": "hashtag_delete_month",
         "close_instead_of_delete": true,
         "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
         "color_name": "pink",
         "color_hex": "#f39de4",
         "reply_to": "thread_reply_to_sender",
         "topic_count": 1789,
         "last_message_date": "2020-09-08T01:22:00-07:00",
         "muted": null,
         "followed": null
      }
    ],
    "poll_id": 64,
    "attachments": [
      {
       "id": 91,
       "media_type": "",
       "download_url": "",
       "image_thumbnail_url": "",
       "filename": "",
      }
    ],
   }
 ],
}

View Message List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Messages

Get the messages within a specified group. Messages are returned using the pagination request and object format.

Permissions Needed

You must have the archives_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` can be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` can be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or .
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

GET /api/v1/getmessages
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getmessages?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getmessages?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getmessages');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 30,
 "start_item": 22,
 "end_item": 53,
 "has_more": false,
 "next_page_token": 48,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "group_perms": 
   {
      "object": "perms",
      "archives_visible": true,
      "polls_visible": true,
      "members_visible": true,
      "chat_visible": true,
      "calendar_visible": true,
      "files_visible": true,
      "database_visible": true,
      "photos_visible": true,
      "wiki_visible": true,
      "member_directory_visible": true,
      "hashtags_visible": true,
      "guidelines_visible": true,
      "subgroups_visible": true,
      "open_donations_visible": true,
      "sponsor_visible": true,
      "manage_subgroups": true,
      "ask_visible": true,
      "delete_group": true,
      "download_archives": true,
      "download_entire_group": true,
      "download_members": true,
      "view_activity": true,
      "create_hashtags": true,
      "manage_hashtags": true,
      "manage_integrations": true,
      "manage_group_settings": true,
      "make_moderator": true,
      "manage_member_subscription_options": true,
      "manage_pending_members": true,
      "remove_members": true,
      "ban_members": true,
      "manage_group_billing": true,
      "manage_group_payments": true,
      "edit_archives": true,
      "manage_pending_messages": true,
      "invite_members": true,
      "can_post": true,
      "can_reply": true,
      "can_vote": true,
      "manage_polls": true,
      "manage_photos": true,
      "manage_members": true,
      "manage_calendar": true,
      "manage_chats": true,
      "view_member_directory": true,
      "manage_files": true,
      "manage_wiki": true,
      "manage_subscription": true,
      "public_page": true,
      "sub_page": true,
      "mod_page": true,
      "can_ask": true
   },
 "group": 
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   },
 "cover_photo_url": "",
 "sub_data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
 "topic": 
   {
      "id": 52691321,
      "object": "topic",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "group_id": 8658933,
      "group_subject_tag": "[StrategyHub]",
      "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
      "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
      "name": "Elenor Schaefer",
      "profile_photo_url": "",
      "num_messages": 22,
      "is_sticky": false,
      "is_moderated": false,
      "is_closed": false,
      "has_attachments": false,
      "reply_to": "thread_reply_group_default",
      "most_recent_message": "2020-09-29T17:03:00-07:00",
      "hashtags": null
   },
 "data": [
   {
    "id": 54,
    "object": "message",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 89,
    "group_id": 7,
    "topic_id": 71,
    "body": "",
    "quoted": "",
    "remainder": "",
    "snippet": "",
    "subject": "",
    "subject_with_tags": "",
    "name": "",
    "profile_photo_url": "",
    "is_plain_text": false,
    "msg_num": 28,
    "is_reply": false,
    "has_liked": false,
    "num_likes": 99,
    "is_closed": false,
    "is_moderated": false,
    "reply_to": "group_reply_only_to_sender",
    "can_repost": false,
    "hashtags": [
      {
         "id": 541,
         "object": "hashtag",
         "created": "2020-09-17T11:22:00-07:00",
         "group_id": 1188,
         "name": "Karl",
         "mods_only_post": false,
         "mods_only_replies": false,
         "no_email": false,
         "moderated": false,
         "special": true,
         "replies_unmoderated": false,
         "locked": true,
         "until": "hashtag_delete_month",
         "close_instead_of_delete": true,
         "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
         "color_name": "pink",
         "color_hex": "#f39de4",
         "reply_to": "thread_reply_to_sender",
         "topic_count": 1789,
         "last_message_date": "2020-09-08T01:22:00-07:00",
         "muted": null,
         "followed": null
      }
    ],
    "poll_id": 83,
    "attachments": [
      {
       "id": 36,
       "media_type": "",
       "download_url": "",
       "image_thumbnail_url": "",
       "filename": "",
      }
    ],
   }
 ],
}

View Message List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Download Archives

Download Archives Download the archives of a group.

Permissions Needed

You must have the download_archives permission to use this call.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
start_msg_num optional number	Only returns messages with a message number greater than this number.
start_time optional date	Only returns messages more recently than this date. In format: 2020-01-25T15:30:15Z.

Returns

Returns an error if the parameters are invalid (e.g. specifying an invalid group id).

Additional Errors

"bad_request"	"invalid start_time format" is returned if the start_time parameter is not formatted correctly.

Notes

The archives will be returned as a .zip file, containing one file in mbox format.
This is a resource intensive call and may take some time to complete. This API call may be changed in the future to a webhook.
This call is rate limited to one call per person per group every 24 hours.

GET /api/v1/downloadarchives
cURL
Go
JavaScript

curl "https://groups.io/api/v1/downloadarchives?group_id=2" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/downloadarchives?group_id=2", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/downloadarchives');
    url.searchParams.append('group_id', '2');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Search Archives

Search the archives. The query string can include the following:

Limiting the search to specific hashtags can be done by include the hashtag names in the query, starting with #.
To exclude specific hashtags, include a dash before the hashtag, like: -#Tagname. Note, this is not currently implemented in the API.
Limiting the search to a specific person's messages can be done by including the text posterid:ID, where ID is the user_id of the person.

Permissions Needed

You must have the archives_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` can be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` can be specified.
q optional string	The query string.
collapse_topics optional boolean	If the results should collapse topics.
exclude_sigs optional boolean	If signature matches should be excluded from the results.
start_date optional date	The start date of the search, in the user's timezone.
end_date optional date	The end date of the search, in the user's timezone.
preset_date_range optional string	Limit the search to a preset date range. Can be: `past_hour`, `past_24_hours`, `past_week`, `past_month`, `past_year`. This is only considered if neither `start_date` nor `end_date` are specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are `relevance` and `created`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the MessageSearchResultsList object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

GET /api/v1/searcharchives
cURL
Go
JavaScript

curl "https://groups.io/api/v1/searcharchives?group_id=12&q=find+this" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/searcharchives?group_id=12&q=find+this", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/searcharchives');
    url.searchParams.append('group_id', '12');
    url.searchParams.append('q', 'find+this');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 23,
 "start_item": 84,
 "end_item": 31,
 "has_more": false,
 "next_page_token": 79,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "query": "",
 "collapse_topics": false,
 "exclude_sigs": false,
 "start_date": "2009-11-10T15:00:00-08:00",
 "end_date": "2009-11-10T15:00:00-08:00",
 "preset_date_range": "",
 "hashtag": 
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   },
 "poster_user_id": 85,
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "data": [
   {
    "id": 58,
    "object": "message_search_result",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 53,
    "topic_id": 29,
    "summary": "",
    "subject": "",
    "body": "",
    "user_id": 14,
    "profile_photo_url": "",
    "name": "",
    "can_view_profile": false,
    "rev_count": 70,
    "msg_num": 36,
    "num_msgs_in_topic": 34,
    "is_closed": false,
    "is_moderated": false,
    "is_sticky": false,
    "has_attachments": false,
    "hashtags": [
      {
         "id": 541,
         "object": "hashtag",
         "created": "2020-09-17T11:22:00-07:00",
         "group_id": 1188,
         "name": "Karl",
         "mods_only_post": false,
         "mods_only_replies": false,
         "no_email": false,
         "moderated": false,
         "special": true,
         "replies_unmoderated": false,
         "locked": true,
         "until": "hashtag_delete_month",
         "close_instead_of_delete": true,
         "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
         "color_name": "pink",
         "color_hex": "#f39de4",
         "reply_to": "thread_reply_to_sender",
         "topic_count": 1789,
         "last_message_date": "2020-09-08T01:22:00-07:00",
         "muted": null,
         "followed": null
      }
    ],
   }
 ],
}

View Message Search Results List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Message History

Get the message history.

Permissions Needed

None.

Query Parameters

group_id optional number	ID of the group. If neither `group_id` nor `group_name` are specified, events from all subscriptions are returned.
group_name optional string	Name of the group. If neither `group_id` nor `group_name` are specified, events from all subscriptions are returned.
offset optional number	Timezone offset, in minutes.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a message history object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.

GET /api/v1/getmessagehistory
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getmessagehistory?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getmessagehistory?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getmessagehistory');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "message_history",
 "month_counts": [
   {
    "object": "month_count",
    "year": 96,
    "month": 12,
    "msgs_sent": 79,
   }
 ],
 "tz_offset": 31,
}

View Message History definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

There are several aspects to the Chat system.

The Chat object represents a chat.
Chats can be subscribed to.

New Chat

Create a new chat. The chat is created and the user is subscribed to the chat.

Permissions Needed

You must have the manage_chats permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
subject required string	The subject of the chat.
desc required string	The description of the chat, in HTML format.
announce required bool	If `true`, send an announcement of the chat to the group.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns a chat object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid subject" is returned if the subject is missing or invalid.
"bad_request"	"invalid desc" is returned if the desc is missing or invalid.

POST /api/v1/newchat
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newchat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "desc=testing" \
  -d "group_id=12" \
  -d "subject=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("desc", "testing")
    data.Set("group_id", "12")
    data.Set("subject", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newchat",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'desc': 'testing',
            'group_id': '12',
            'subject': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newchat', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 52691321,
   "object": "chat",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "profile_photo_url": "",
   "name": "",
   "can_view_profile": false,
   "group_id": 8658933,
   "subject": "Including.",
   "desc": "Tribe anything from.",
   "is_closed": false,
   "num_messages": 21,
   "chat_sub": {
     "id": 179889653,
     "object": "chat_sub",
     "created": "2020-09-10T11:42:00-07:00",
     "updated": "2023-03-29T23:48:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "chat_id": 52691321,
     "last_msg_seen": 40
   }
}

View Chat definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Chat

Update a chat object.

Permissions Needed

You must be the owner of the chat.

POST Parameters

chat_id required number	ID of the chat to update. You must be the owner of the chat.
csrf required string	The `csrf_token` from the user object returned when first logged in.
subject optional string	The subject of the chat.
desc optional string	The description of the chat, in HTML format.
is_closed optional boolean	If the chat is closed.

Returns

Returns the chat object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid chat_id" is returned if the chat id is missing or invalid.

POST /api/v1/updatechat
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatechat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "chat_id=12" \
  -d "desc=testing" \
  -d "subject=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("chat_id", "12")
    data.Set("desc", "testing")
    data.Set("subject", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatechat",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'chat_id': '12',
            'desc': 'testing',
            'subject': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatechat', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 52691321,
   "object": "chat",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "profile_photo_url": "",
   "name": "",
   "can_view_profile": false,
   "group_id": 8658933,
   "subject": "Including.",
   "desc": "Tribe anything from.",
   "is_closed": false,
   "num_messages": 21,
   "chat_sub": {
     "id": 179889653,
     "object": "chat_sub",
     "created": "2020-09-10T11:42:00-07:00",
     "updated": "2023-03-29T23:48:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "chat_id": 52691321,
     "last_msg_seen": 40
   }
}

View Chat definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Chats

Get chats. Chats are returned using the pagination request and object format.

Permissions Needed

You must have the chat_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
show_closed optional boolean	If `true`, return closed chats. Otherwise return open chats.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.

Returns

Returns a chat list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getchats
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getchats?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getchats?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getchats');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "chat",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
       "group_id": 8658933,
       "subject": "Including.",
       "desc": "Tribe anything from.",
       "is_closed": false,
       "num_messages": 21,
       "chat_sub": {
         "id": 179889653,
         "object": "chat_sub",
         "created": "2020-09-29T17:03:00-07:00",
         "updated": "2022-06-18T23:30:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "chat_id": 52691321,
         "last_msg_seen": 40
       }
     },
     {
       "id": 195168922,
       "object": "chat",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
       "group_id": 8658933,
       "subject": "Pyramid.",
       "desc": "Accordingly onto moreover.",
       "is_closed": false,
       "num_messages": 81,
       "chat_sub": {
         "id": 83034458,
         "object": "chat_sub",
         "created": "2020-09-06T02:40:00-07:00",
         "updated": "2020-10-07T01:03:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "chat_id": 195168922,
         "last_msg_seen": 90
       }
     },
     {
       "id": 182971401,
       "object": "chat",
       "created": "2020-09-24T00:10:00-07:00",
       "updated": "2021-05-19T19:29:00-07:00",
       "user_id": 147779411,
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
       "group_id": 8658933,
       "subject": "Fear.",
       "desc": "Usually body kilometer.",
       "is_closed": false,
       "num_messages": 198,
       "chat_sub": {
         "id": 122478329,
         "object": "chat_sub",
         "created": "2020-08-30T21:35:00-07:00",
         "updated": "2023-05-02T01:56:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "chat_id": 182971401,
         "last_msg_seen": 84
       }
     }
   ]
}

View Chat List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Chat

Delete a chat object.

Permissions Needed

You must be the owner of the chat.

POST Parameters

chat_id required number	ID of the chat to delete. You must be the owner of the chat.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid chat_id" is returned if the chat id is missing or invalid.

POST /api/v1/deletechat
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletechat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "chat_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("chat_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletechat",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'chat_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletechat', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Join Chat

Join a chat.

Permissions Needed

You must have the chat_visible permission to use this call with a group.

POST Parameters

chat_id required number	ID of the chat to join.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns a chat sub object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid chat_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid chat_id" is returned if the chat id is missing or invalid.
"bad_request"	"closed chat" is returned if the chat has been closed.
"bad_request"	"already subscribed" is returned if the user is already subscribed to the chat.

POST /api/v1/joinchat
cURL
Go
JavaScript

curl "https://groups.io/api/v1/joinchat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "chat_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("chat_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/joinchat",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'chat_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/joinchat', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 179889653,
   "object": "chat_sub",
   "created": "2020-09-10T11:42:00-07:00",
   "updated": "2023-03-29T23:48:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "chat_id": 52691321,
   "last_msg_seen": 40
}

View Chat Sub definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Chat Members

Get a list of the members of the chat.

Permissions Needed

You must be subscribed to the chat.

POST Parameters

chatsub_id required number	ID of the chatsub. You must be the owner of the chatsub.

Returns

Returns a member info list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid chatsub_id" is returned if the chatsub id is missing or invalid.
"bad_request"	"closed chat" is returned if the chat has been closed.

POST /api/v1/chatmembers
cURL
Go
JavaScript

curl "https://groups.io/api/v1/chatmembers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "chatsub_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("chatsub_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/chatmembers",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'chatsub_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/chatmembers', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 99,
 "start_item": 84,
 "end_item": 9,
 "has_more": false,
 "next_page_token": 4,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Member Info List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Leave Chat

Leave a chat. Generally you do not want to use this. The normal way to leave a chat is to send a /leave message to an open chat.

Permissions Needed

You must be subscribed to the chat.

POST Parameters

chatsub_id required number	ID of the chatsub to delete. You must be the owner of the chatsub.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid chatsub_id" is returned if the chatsub id is missing or invalid.

POST /api/v1/leavechat
cURL
Go
JavaScript

curl "https://groups.io/api/v1/leavechat" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "chatsub_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("chatsub_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/leavechat",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'chatsub_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/leavechat', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Chat History

Get chat history. Chat messages are returned using the pagination request and object format.

Permissions Needed

You must be subscribed to the group.

GET Parameters

chat_id required number	ID of the chat to view.

Returns

Returns a chat message list object if successful. Returns an error if there is an error. Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid chat_id" is returned if the chat id is missing or invalid.

GET /api/v1/getchathistory
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getchathistory" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getchathistory", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getchathistory', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 179889653,
       "object": "chat_message",
       "created": "2020-09-29T17:03:00-07:00",
       "version": 5,
       "user_id": 147779411,
       "group_id": 8658933,
       "chat_id": 52691321,
       "type": "chat_msg_type_normal",
       "message": "Market pyramid..",
       "msg_num": 179889653,
       "delete_msg_num": 0,
       "media": null,
       "tapbacks": [
         {
           "user_id": 51506187,
           "sub_id": 14243141,
           "type": "chat_msg_tapback_thumbs_up"
         },
         {
           "user_id": 97752942,
           "sub_id": 10287162,
           "type": "chat_msg_tapback_laugh"
         }
       ],
       "tapback_counts": [
         {
           "type": "chat_msg_tapback_heart",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_thumbs_up",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_thumbs_down",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_laugh",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_exclamation",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_question",
           "count": 0
         }
       ],
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://picsum.photos/id/53/498/325",
       "profile_privacy": "profile_private",
       "profile_color": "#837fd5",
       "email": "gersonbeahan@..."
     },
     {
       "id": 154675724,
       "object": "chat_message",
       "created": "2020-09-14T23:24:00-07:00",
       "version": 5,
       "user_id": 147779411,
       "group_id": 8658933,
       "chat_id": 10192753,
       "type": "chat_msg_type_normal",
       "message": "Lebanese Guyanese you herself greatly one being nest. When itself yet unless outfit were anybody these.",
       "msg_num": 154675724,
       "delete_msg_num": 0,
       "media": null,
       "tapbacks": [
         {
           "user_id": 196646336,
           "sub_id": 144338940,
           "type": "chat_msg_tapback_question"
         },
         {
           "user_id": 123317449,
           "sub_id": 174167102,
           "type": "chat_msg_tapback_heart"
         },
         {
           "user_id": 115712626,
           "sub_id": 20535086,
           "type": "chat_msg_tapback_thumbs_down"
         },
         {
           "user_id": 92539812,
           "sub_id": 54982055,
           "type": "chat_msg_tapback_thumbs_down"
         },
         {
           "user_id": 110808615,
           "sub_id": 161817060,
           "type": "chat_msg_tapback_laugh"
         },
         {
           "user_id": 89933098,
           "sub_id": 19594331,
           "type": "chat_msg_tapback_heart"
         }
       ],
       "tapback_counts": [
         {
           "type": "chat_msg_tapback_heart",
           "count": 2
         },
         {
           "type": "chat_msg_tapback_thumbs_up",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_thumbs_down",
           "count": 2
         },
         {
           "type": "chat_msg_tapback_laugh",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_exclamation",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_question",
           "count": 1
         }
       ],
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://picsum.photos/id/53/498/325",
       "profile_privacy": "profile_private",
       "profile_color": "#837fd5",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "chat_message",
       "created": "2020-09-20T09:51:00-07:00",
       "version": 5,
       "user_id": 147779411,
       "group_id": 8658933,
       "chat_id": 137070462,
       "type": "chat_msg_type_normal",
       "message": "What few why where win most would everybody them backwards this that. Provided store elegance joy group Senegalese whichever happen trade move outside downstairs. Of exemplified up out destroy due taste anything where this that would. Whom to cautiously till only himself fight our whomever that for her. Our much nevertheless which numerous alone bevy as by from e.g. otherwise. Laptop cloud then them yourselves few look fleet say still patrol finally. Vietnamese painting otherwise its to a e.g. congregation cackle themselves previously in. For theirs they my there road disappear accordingly hotel so today by. Over have this Romanian abroad around while belong ever into each whatever.",
       "msg_num": 189377967,
       "delete_msg_num": 0,
       "media": null,
       "tapbacks": [
         {
           "user_id": 91729622,
           "sub_id": 141481456,
           "type": "chat_msg_tapback_laugh"
         },
         {
           "user_id": 55138761,
           "sub_id": 139522588,
           "type": "chat_msg_tapback_thumbs_up"
         }
       ],
       "tapback_counts": [
         {
           "type": "chat_msg_tapback_heart",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_thumbs_up",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_thumbs_down",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_laugh",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_exclamation",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_question",
           "count": 0
         }
       ],
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://picsum.photos/id/53/498/325",
       "profile_privacy": "profile_private",
       "profile_color": "#837fd5",
       "email": "gersonbeahan@..."
     }
   ]
}

View Chat Message List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Databases

Get databases. Databases are returned using the pagination request and object format.

Permissions Needed

You must have the database_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a database list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getdatabases
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getdatabases?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getdatabases?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getdatabases');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 84,
 "start_item": 66,
 "end_item": 6,
 "has_more": false,
 "next_page_token": 45,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 31,
    "object": "databasetable",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 47,
    "user_id": 21,
    "name": "",
    "short_desc": "",
    "desc": "",
    "desc_type": "",
    "edit_table": "database_access_all",
    "edit_rows": "database_access_all",
    "add_rows": "database_access_all",
    "view_table": "database_access_all",
    "num_rows": 43,
    "max_row_id": 81,
    "num_columns": 47,
    "max_col_id": 46,
    "display_template": "",
    "columns": [
      {
         "id": 52691321,
         "name": "Multiple Choice: Including tribe anything from whose.",
         "type": "multiple_choice_column",
         "required": true,
         "color": "color_orchid",
         "choices": [
           "Next each secondly must catch politely.",
           "Sleepy where i.e. inquisitively yours wisp.",
           "Regularly nice cackle ourselves heavily now."
         ],
         "width": 0,
         "default_hidden": false,
         "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
      }
    ],
    "id_default_hidden": false,
    "updated_default_hidden": false,
   }
 ],
}

View Database Table List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Database Rows

Get database rows. Database rows are returned using the pagination request and object format.

Permissions Needed

You must have the database_visible permission to use this call with a group.

Query Parameters

database_id required number	ID of the database.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a database row list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getdatabaserows
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getdatabaserows?database_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getdatabaserows?database_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getdatabaserows');
    url.searchParams.append('database_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 95,
 "start_item": 94,
 "end_item": 42,
 "has_more": false,
 "next_page_token": 71,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 61,
    "object": "databaserow",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 12,
    "table_id": 60,
    "row_num": 43,
    "vals": [
      {
       "col_id": 79,
       "col_type": "address_column",
       "text": "",
       "html_text": "",
       "date": "2009-11-10T15:00:00-08:00",
       "time": "2009-11-10T15:00:00-08:00",
       "checked": false,
       "multi_choice": [4],
       "street_address1": "",
       "street_address2": "",
       "city": "",
       "state": "",
       "zip": "",
       "country": "",
       "lat": "",
       "lng": "",
       "title": "",
       "url": "",
       "desc": "",
       "image_name": "",
       "image_data": [""],
       "number": "",
       "github_login": "",
       "github_name": "",
       "github_email": "",
       "github_avatar_url": "",
       "github_profile_url": "",
       "github_id": 69,
       "github_company": "",
       "github_location": "",
       "github_bio": "",
      }
    ],
    "num_vals": 96,
   }
 ],
}

View Database Row List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Delivery Info

Get a user's group specific delivery information.

Permissions Needed

None if viewing your own delivery information. If viewing another member's delivery information, you need the manage_members permission.

Query Parameters

group_id optional number	ID of the group. If neither `group_id` nor `group_name` are specified, events from all subscriptions are returned.
group_name optional string	Name of the group. If neither `group_id` nor `group_name` are specified, events from all subscriptions are returned.
member_info_id optional number	If specified, return the delivery information for this member. You must have the `manage_members` permission to specify this.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a delivery info object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.

GET /api/v1/getdeliveryinfo
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getdeliveryinfo?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getdeliveryinfo?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getdeliveryinfo');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "delivery_info",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 40,
 "success_msg_id": 23,
 "success_time": "2009-11-10T15:00:00-08:00",
 "success_subject": "",
 "success_type": "delivery_bounce_probe",
 "success_response": "",
 "attempt_msg_id": 65,
 "attempt_time": "2009-11-10T15:00:00-08:00",
 "attempt_subject": "",
 "attempt_type": "delivery_bounce_probe",
 "attempt_response": "",
 "bounces": [
   {
    "object": "bounce_info",
    "created": "2009-11-10T15:00:00-08:00",
    "group_id": 12,
    "msg_id": 10,
    "subject": "",
    "response": "",
    "is_hard": false,
    "type": "delivery_bounce_probe",
   }
 ],
}

View Delivery Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Bounce Info

Get a user's bounce information.

Permissions Needed

None.

Query Parameters

limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a bounce info list object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

	None.

GET /api/v1/getbounceinfo
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getbounceinfo" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getbounceinfo", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getbounceinfo', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 12,
 "start_item": 57,
 "end_item": 5,
 "has_more": false,
 "next_page_token": 2,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "object": "bounce_info",
    "created": "2009-11-10T15:00:00-08:00",
    "group_id": 32,
    "msg_id": 38,
    "subject": "",
    "response": "",
    "is_hard": false,
    "type": "delivery_bounce_probe",
   }
 ],
}

View Bounce Info List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

A draft represent a post as it is being written. The sequence to post a message to a group is as follows:

Create a new draft with /newdraft.
Compose the message, periodically saving it with /updatedraft.
Optionally add attachments, using /addattachments.
Once complete, sending the draft as a message with /postdraft.

There are also several draft maintenance endpoints.

New Draft

Create a new draft object.

Permissions Needed

You must have the can_post permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
draft_type required string	Type of draft. Currently, `draft_type_post`, `draft_type_reply`, `draft_type_post_to_sub` and `draft_type_dm` are the only allowed types.
csrf required string	The `csrf_token` from the user object returned when first logged in.
message_id may be required number	If this is a 'draft_type_reply', you must specify the ID of the message you are replying to.
dm_member_id may be required number	If this is a `draft_type_dm`, you must specify the ID of the member you are sending a message to.
member_id may be required number	If this is a `draft_type_post_to_sub`, you must specify the ID of the member you are sending a message to. You can specify more than one member_ids.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the draft object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid draft_type" is returned if the draft type is missing or invalid.
"bad_request"	"missing dm_member_id" is returned if the draft type is `draft_type_dm` and `dm_member_id` is missing.

POST /api/v1/newdraft
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newdraft" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newdraft",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newdraft', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 29,
 "object": "draft",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 84,
 "group_id": 76,
 "draft_type": "",
 "subject": "",
 "body": "",
 "body_type": "",
 "is_special": false,
 "num_attachments": 32,
 "next_attachment_id": 7,
 "message_id": 52,
 "bcc_me": false,
 "bcc_all": false,
}

View Draft definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Draft

Update a draft object.

Permissions Needed

You must be the owner of the draft.

POST Parameters

draft_id required number	ID of the draft to update. You must be the owner of the draft.
csrf required string	The `csrf_token` from the user object returned when first logged in.
subject optional string	Subject of the draft.
body optional string	Body of the draft, in HTML.
is_special optional boolean	If this post should be sent as a special message (only applies to moderators/owners).
is_private optional boolean	If the private button has been toggled.
bcc_me optional boolean	If the sender should be BCC'ed when this draft is posted (only applies to `draft_type_reply`)
bcc_all optional boolean	If all moderators should be BCC'ed when this draft is posted (only applies to `draft_type_post_to_sub`).
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the draft object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid draft_id" is returned if the draft id is missing or invalid.

POST /api/v1/updatedraft
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatedraft" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "draft_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("draft_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatedraft",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'draft_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatedraft', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 93,
 "object": "draft",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 19,
 "group_id": 33,
 "draft_type": "",
 "subject": "",
 "body": "",
 "body_type": "",
 "is_special": false,
 "num_attachments": 96,
 "next_attachment_id": 66,
 "message_id": 53,
 "bcc_me": false,
 "bcc_all": false,
}

View Draft definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Drafts

Get drafts. Drafts are returned using the pagination request and object format.

Permissions Needed

None

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are `created` or `subject`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a draft list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getdrafts
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getdrafts" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getdrafts", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getdrafts', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 65,
 "start_item": 56,
 "end_item": 30,
 "has_more": false,
 "next_page_token": 14,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 96,
    "object": "draft",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 51,
    "group_id": 9,
    "draft_type": "",
    "subject": "",
    "body": "",
    "body_type": "",
    "is_special": false,
    "num_attachments": 56,
    "next_attachment_id": 21,
    "message_id": 21,
    "bcc_me": false,
    "bcc_all": false,
   }
 ],
}

View Draft List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Draft

Delete a draft object.

Permissions Needed

You must be the owner of the draft.

POST Parameters

draft_id required number	ID of the draft to delete. You must be the owner of the draft.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid draft_id" is returned if the draft id is missing or invalid.

POST /api/v1/deletedraft
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletedraft" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "draft_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("draft_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletedraft",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'draft_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletedraft', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Upload Attachments

Upload attachments as part of a draft.

Permissions Needed

You must be the owner of the draft.

POST Parameters

draft_id required number	ID of the draft to associate the attachment to. You must be the owner of the draft.
fileupload required multipart file	Multipart file upload of one or more attachments.
csrf required string	The `csrf_token` from the user object returned when first logged in.
inline optional boolean	If the attachments are inline images.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a draft attachment list object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid draft_id" is returned if the draft id is missing or invalid.

POST /api/v1/uploadattachments
cURL
Go
JavaScript

curl "https://groups.io/api/v1/uploadattachments" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/uploadattachments",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/uploadattachments', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 31,
 "start_item": 89,
 "end_item": 61,
 "has_more": false,
 "next_page_token": 61,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 46,
    "object": "draft_attachment",
    "draft_id": 98,
    "url": "",
    "filename": "",
    "size": 6,
    "content_type": "",
    "inline": false,
   }
 ],
}

View Draft Attachment List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Attachments

Get attachments.

Permissions Needed

You must be the owner of the draft.

POST Parameters

draft_id required number	ID of the draft containing the attachments. You must be the owner of the draft.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a draft attachment list object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid draft_id" is returned if the draft id is missing or invalid.

GET /api/v1/getattachments
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getattachments?draft_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getattachments?draft_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getattachments');
    url.searchParams.append('draft_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 27,
 "start_item": 19,
 "end_item": 22,
 "has_more": false,
 "next_page_token": 1,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 60,
    "object": "draft_attachment",
    "draft_id": 24,
    "url": "",
    "filename": "",
    "size": 0,
    "content_type": "",
    "inline": false,
   }
 ],
}

View Draft Attachment List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Attachment

Delete an attachment.

Permissions Needed

You must be the owner of the draft and attachment.

POST Parameters

draft_id required number	ID of the draft containing the attachment to delete. You must be the owner of the draft.
attachment_id required number	Attachment ID to delete.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid draft_id" is returned if the draft id is missing or invalid.
"bad_request"	"invalid attachment_id" is returned if the attachment ID is missing or invalid.

POST /api/v1/deleteattachment
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deleteattachment" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "draft_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("draft_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deleteattachment",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'draft_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deleteattachment', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Post Draft

Post Draft.

Permissions Needed

You must be the owner of the draft. You must have the can_post permission in the group.

POST Parameters

draft_id required number	ID of the draft to post. You must be the owner of the draft.
csrf required string	The `csrf_token` from the user object returned when first logged in.
reply optional string	Only applicable if this draft is a reply to a message. Possible values are: `sender`, `group_and_sender`, `mods`.
from_owner optional boolean	Only applicable if this draft is a new post and the poster is a moderator or owner of the group. If `true`, send the post from the groupname+owner email address.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a success object on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Success Responses

"pending post"	Returned if the post requires approval before it is sent to the group.

Additional Errors

"bad_request"	"invalid draft_id" is returned if the draft id is missing or invalid.
"bad_request"	"no subject" is returned if the draft is missing a subject.
"bad_request"	"no body" is returned if the draft is missing a body.
"bad_request"	"need hashtag" is returned if the subject needs a hashtag.
"bad_request"	"restricted hashtag" is returned if the subject contains a hashtag that the user does not have permission to use.
"bad_request"	"mod only hashtag" is returned if the subject contains a hashtag that only moderators/owners can use.
"bad_request"	"private message" is returned if the subject starts with "Private:".
"bad_request"	"post too big" is returned if the body is too large to send.
"bad_request"	"announcement group" is returned if the group is an announcement group and the sender is not a moderator/owner.
"bad_request"	"group out of space" is returned if the group is out of space.
"bad_request"	"bad attachment" is returned if the message contains an attachment that isn't allowed.
"bad_request"	"not subscribed" is returned if the user is not subscribed to the group.
"bad_request"	"invalid reply" is returned if the `reply` parameter is invalid.

POST /api/v1/postdraft
cURL
Go
JavaScript

curl "https://groups.io/api/v1/postdraft" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "draft_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("draft_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/postdraft",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'draft_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/postdraft', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

With RSVPs, here is the flow:

When viewing an event, if the rsvp field of the Event object is true, an RSVP is requested.
If the comment_label field in the Event is not empty, display a text field for entry of a comment.
If the additional_guests field of the Event object is true, display a drop down to select the number of additional guests.
If the has_rsvp field of the Event object is false, display three buttons: Will Attend, Will Not Attend, Not Sure.
If the has_rsvp field of the Event object is true, the rsvp_type, rsvp_comment and rsvp_additional_guests fields represent the previous RSVP response.
If the rsvp_type is rsvp_waitlist, that means the person is waitlisted. In this case, the Will Attend button should be 'Update Waitlisted'. This button should return a response value of rsvp_yes, not rsvp_waitlist.
On successfully calling the /v1/rsvp endpoint, an rsvp object is returned. If the type field is set to rsvp_waitlist, that means the user has been waitlisted, and a message should be shown to them announcing that.

Event Reminders:

Event reminders are notifications sent before an event starts. They support various time intervals and can be sent as regular or special notices.

Setting Reminders:

Reminders are specified using three parallel arrays: reminder_interval, reminder_type, and reminder_special
reminder_interval: The numeric amount (e.g., 15 for 15 minutes, 2 for 2 days)
reminder_type: The unit of time as a JSON string: "reminder_type_minutes", "reminder_type_hours", "reminder_type_days", "reminder_type_weeks"
reminder_special: "true" for special notice (higher priority), omit for regular

Examples:

15 minutes before: reminder_interval[0]=15&reminder_type[0]=reminder_type_minutes
1 hour before: reminder_interval[0]=1&reminder_type[0]=reminder_type_hours
2 days before: reminder_interval[0]=2&reminder_type[0]=reminder_type_days
1 week before: reminder_interval[0]=1&reminder_type[0]=reminder_type_weeks

Multiple Reminders: You can set multiple reminders by using array indices:

reminder_interval[0]=15&reminder_type[0]=reminder_type_minutes (15 minutes)
reminder_interval[1]=1&reminder_type[1]=reminder_type_hours (1 hour)
reminder_interval[2]=1&reminder_type[2]=reminder_type_days&reminder_special[2]=true (1 day, special notice)

For Recurring Events:

Reminders apply to all occurrences in the series
When a series is updated, reminders are recalculated for all future events
Individual occurrences can have different reminders if they are overridden (detached)

Get Event

Get a single event.

Permissions Needed

You must be subscribed to the group associated with the event.

Query Parameters

event_id required number	The ID of the event to return.

Returns

Returns the event object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call. extended - optional, boolean: If true, the endpoint will return additional information. See Extended Return Information for more information.

Additional Errors

"bad_request"	"invalid event_id" is returned if the event id is missing or invalid.
"bad_request"	"not subscribed to group" is returned if the event belongs to a group the user is not a member of.

GET /api/v1/getevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getevent?event_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getevent?event_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getevent');
    url.searchParams.append('event_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 96,
 "object": "event",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "creator_name": "@JohnSmith",
 "group_id": 37,
 "group_name": "",
 "nice_group_name": "",
 "start_time": "2009-11-10T15:00:00-08:00",
 "end_time": "2009-11-10T15:00:00-08:00",
 "timezone": "",
 "all_day": false,
 "name": "",
 "location": "",
 "description": "",
 "organizer_name": "",
 "organizer_email": "",
 "organizer_phone": "",
 "color_name": "color_antique_pink",
 "color_hex": "",
 "rsvp": false,
 "max_attendees": 33,
 "additional_guests": false,
 "comment_label": "",
 "yes_message": "",
 "has_rsvp": false,
 "rsvp_type": "",
 "rsvp_comment": "",
 "rsvp_additional_guests": 71,
}

View Event definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Events

Get a set of events. If group_id or group_name are specified, only events from those groups are returned. If neither are specified, events from all the groups subscribed to by the logged in user are returned. Event objects are returned using the pagination request and object format.

Query Parameters

start required string	The earliest date to return events from. In the form YYYY-MM-DD.
end optional string	The latest date to return events from. In the form YYYY-MM-DD.
group_id optional number	ID of the group. If neither `group_id` nor `group_name` are specified, events from all subscriptions are returned.
group_name optional string	Name of the group. If neither `group_id` nor `group_name` are specified, events from all subscriptions are returned.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response. You must also continue to specify the same `start` and `end` parameters.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

GET /api/v1/getevents
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getevents?start=2019-06-19&limit=2" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getevents?start=2019-06-19&limit=2", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getevents');
    url.searchParams.append('limit', '2');
    url.searchParams.append('start', '2019-06-19');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 57,
 "start_item": 48,
 "end_item": 94,
 "has_more": false,
 "next_page_token": 16,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 42,
    "object": "event",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "creator_name": "@JohnSmith",
    "group_id": 79,
    "group_name": "",
    "nice_group_name": "",
    "start_time": "2009-11-10T15:00:00-08:00",
    "end_time": "2009-11-10T15:00:00-08:00",
    "timezone": "",
    "all_day": false,
    "name": "",
    "location": "",
    "description": "",
    "organizer_name": "",
    "organizer_email": "",
    "organizer_phone": "",
    "color_name": "color_antique_pink",
    "color_hex": "",
    "rsvp": false,
    "max_attendees": 94,
    "additional_guests": false,
    "comment_label": "",
    "yes_message": "",
    "has_rsvp": false,
    "rsvp_type": "",
    "rsvp_comment": "",
    "rsvp_additional_guests": 70,
   }
 ],
}

View Event List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

RSVP To An Event

RSVP to an event.

Permissions Needed

You must be subscribed to the group.

POST Parameters

event_id required number	ID of the event to RSVP to. You must be subscribed to the group.
response required string	Can be one of: `rsvp_maybe`, `rsvp_no`, `rsvp_yes`.
additional_guests required number
comment required string
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the rsvp object. Returns an error if parameters are invalid (e.g. specifying an invalid event_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid event_id" is returned if the event id is missing or invalid.
"bad_request"	"locked event" is returned if the event has been locked.
"bad_request"	"not subscribed" is returned if the user is not subscribed to the group.
"bad_request"	"waitlist response" is returned if the response field is `rsvp_waitlist`.

Notes

rsvp_waitlist is not a valid value for response. The user should only be given the options of Yes, No, or Maybe.
If the response is rsvp_yes, check the type field of the returned RSVP object. If it is rsvp_waitlist, the person has been waitlisted.

POST /api/v1/rsvp
cURL
Go
JavaScript

curl "https://groups.io/api/v1/rsvp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "event_id=12" \
  -d "response=rsvp_yes"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("event_id", "12")
    data.Set("response", "rsvp_yes")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/rsvp",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'event_id': '12',
            'response': 'rsvp_yes'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/rsvp', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 94,
 "object": "rsvp",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "event_id": 19,
 "group_id": 55,
 "user_id": 42,
 "user_name": "",
 "full_name": "",
 "email": "",
 "profile_photo_url": "",
 "type": "rsvp_maybe",
 "comment": "",
 "additional_guests": 98,
}

View RSVP definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Add Event

Add a new event.

Permissions Needed

You must have calendar management permissions for the group.

POST Parameters

group_id required number	ID of the group.
name required string	Event name.
description optional string	Event description.
location optional string	Event location.
start_time required string	Event start time in ISO 8601 format.
end_time required string	Event end time in ISO 8601 format.
timezone required string	Timezone for the event.
all_day optional boolean	Whether this is an all-day event.
rsvp optional boolean	Whether to request RSVPs.
max_attendees optional number	Maximum number of attendees.
additional_guests optional boolean	Whether to allow additional guests.
send_notice optional boolean	Whether to send a notice about the event.
organizer_name optional string	Organizer name.
organizer_email optional string	Organizer email.
organizer_phone optional string	Organizer phone.
color optional string	Event color.
format optional number	Event format (plain text, markdown, etc).
yes_message optional string	Message to show when someone RSVPs yes.
comment_label optional string	Label for the comment field.
reminder_interval optional number (multiple)	Array of reminder intervals. The amount of time before the event to send the reminder.
reminder_type optional string (multiple)	Array of reminder types. Values: "reminder_type_minutes", "reminder_type_hours", "reminder_type_days", "reminder_type_weeks".
reminder_special optional string (multiple)	Array of special notice flags. Set to "true" to send as special notice, omit for regular reminder.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information.

Setting Reminders

Reminders are sent before an event starts. Provide parallel arrays with matching indices:

reminder_interval[0]=15&reminder_type[0]=reminder_type_minutes (15 minutes before)
reminder_interval[1]=1&reminder_type[1]=reminder_type_days (1 day before)
reminder_interval[2]=1&reminder_type[2]=reminder_type_weeks&reminder_special[2]=true (1 week before, special notice)

Returns

Returns the created event object. Returns an error if parameters are invalid.

Additional Errors

"bad_request"	"invalid subscription" is returned if the user is not subscribed to the group.
"bad_request"	"invalid group" is returned if the group is invalid.
"bad_request"	"no permission" is returned if the user doesn't have calendar management permissions.

POST /api/v1/addevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/addevent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "end_time=2024-01-15T11:00:00Z" \
  -d "group_id=12" \
  -d "name=Team%20Meeting" \
  -d "reminder_interval[0]=15" \
  -d "reminder_interval[1]=1" \
  -d "reminder_special[1]=true" \
  -d "reminder_type[0]=reminder_type_minutes" \
  -d "reminder_type[1]=reminder_type_days" \
  -d "start_time=2024-01-15T10:00:00Z" \
  -d "timezone=America/New_York"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("end_time", "2024-01-15T11:00:00Z")
    data.Set("group_id", "12")
    data.Set("name", "Team%20Meeting")
    data.Set("reminder_interval[0]", "15")
    data.Set("reminder_interval[1]", "1")
    data.Set("reminder_special[1]", "true")
    data.Set("reminder_type[0]", "reminder_type_minutes")
    data.Set("reminder_type[1]", "reminder_type_days")
    data.Set("start_time", "2024-01-15T10:00:00Z")
    data.Set("timezone", "America/New_York")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/addevent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'end_time': '2024-01-15T11:00:00Z',
            'group_id': '12',
            'name': 'Team%20Meeting',
            'reminder_interval[0]': '15',
            'reminder_interval[1]': '1',
            'reminder_special[1]': 'true',
            'reminder_type[0]': 'reminder_type_minutes',
            'reminder_type[1]': 'reminder_type_days',
            'start_time': '2024-01-15T10:00:00Z',
            'timezone': 'America/New_York'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/addevent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 41,
 "object": "event",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "creator_name": "@JohnSmith",
 "group_id": 94,
 "group_name": "",
 "nice_group_name": "",
 "start_time": "2009-11-10T15:00:00-08:00",
 "end_time": "2009-11-10T15:00:00-08:00",
 "timezone": "",
 "all_day": false,
 "name": "",
 "location": "",
 "description": "",
 "organizer_name": "",
 "organizer_email": "",
 "organizer_phone": "",
 "color_name": "color_antique_pink",
 "color_hex": "",
 "rsvp": false,
 "max_attendees": 29,
 "additional_guests": false,
 "comment_label": "",
 "yes_message": "",
 "has_rsvp": false,
 "rsvp_type": "",
 "rsvp_comment": "",
 "rsvp_additional_guests": 96,
}

View Event definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Event

Update an existing event.

Permissions Needed

You must have calendar management permissions for the group or be the event creator.

POST Parameters

event_id required number	ID of the event to update.
name required string	Event name.
description optional string	Event description.
location optional string	Event location.
start_time required string	Event start time in ISO 8601 format.
end_time required string	Event end time in ISO 8601 format.
timezone required string	Timezone for the event.
all_day optional boolean	Whether this is an all-day event.
rsvp optional boolean	Whether to request RSVPs.
max_attendees optional number	Maximum number of attendees.
additional_guests optional boolean	Whether to allow additional guests.
send_notice optional boolean	Whether to send a notice about the event.
organizer_name optional string	Organizer name.
organizer_email optional string	Organizer email.
organizer_phone optional string	Organizer phone.
color optional string	Event color.
format optional number	Event format (plain text, markdown, etc).
yes_message optional string	Message to show when someone RSVPs yes.
comment_label optional string	Label for the comment field.
reminder_interval optional number (multiple)	Array of reminder intervals. The amount of time before the event to send the reminder.
reminder_type optional string (multiple)	Array of reminder types. Values: "reminder_type_minutes", "reminder_type_hours", "reminder_type_days", "reminder_type_weeks".
reminder_special optional string (multiple)	Array of special notice flags. Set to "true" to send as special notice, omit for regular reminder.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information.

Updating Reminders

To update reminders, provide new arrays which will replace all existing reminders:

reminder_interval[0]=30&reminder_type[0]=reminder_type_minutes (30 minutes before)
To remove all reminders, omit the reminder parameters entirely

Returns

Returns success status. Returns an error if parameters are invalid.

Additional Errors

"bad_request"	"invalid event_id" is returned if the event id is missing or invalid.
"bad_request"	"locked event" is returned if the event has been locked.
"bad_request"	"no permission" is returned if the user doesn't have permission to edit the event.

POST /api/v1/updateevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updateevent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "end_time=2024-01-15T11:00:00Z" \
  -d "event_id=123" \
  -d "name=Updated%20Meeting" \
  -d "reminder_interval[0]=30" \
  -d "reminder_type[0]=reminder_type_minutes" \
  -d "start_time=2024-01-15T10:00:00Z" \
  -d "timezone=America/New_York"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("end_time", "2024-01-15T11:00:00Z")
    data.Set("event_id", "123")
    data.Set("name", "Updated%20Meeting")
    data.Set("reminder_interval[0]", "30")
    data.Set("reminder_type[0]", "reminder_type_minutes")
    data.Set("start_time", "2024-01-15T10:00:00Z")
    data.Set("timezone", "America/New_York")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updateevent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'end_time': '2024-01-15T11:00:00Z',
            'event_id': '123',
            'name': 'Updated%20Meeting',
            'reminder_interval[0]': '30',
            'reminder_type[0]': 'reminder_type_minutes',
            'start_time': '2024-01-15T10:00:00Z',
            'timezone': 'America/New_York'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updateevent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "success",
 "extra": "",
}

View Success definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Add Repeat Event

Add a new repeating event series.

Permissions Needed

You must have calendar management permissions for the group.

POST Parameters

group_id required number	ID of the group.
name required string	Name of the event series.
description optional string	Description of the event series.
location optional string	Location of the event series.
start_time required string	Start time of first occurrence in RFC3339 format.
duration required number	Duration of each event in seconds.
timezone required string	Timezone for the event series (e.g., "America/New_York").
all_day optional boolean	Whether this is an all-day event series.
repeat_type required number	Type of repeat (1=daily, 2=weekly, 3=monthly, 4=yearly).
repeat_interval optional number	Interval for repeating (e.g., every 2 weeks). Default is 1.
repeat_ends required number	How the repeat ends (0=never, 1=date, 2=times).
repeat_until optional string	End date for repeating events (required if repeat_ends=1).
repeat_times optional number	Number of times to repeat (required if repeat_ends=2).
sun, mon, tue, wed, thu, fri, sat optional boolean	Days of week for weekly repeats.
month_type optional number	Type of monthly repeat (0=day of month, 1=week of month).
organizer_name optional string	Name of the event organizer.
organizer_email optional string	Email of the event organizer.
organizer_phone optional string	Phone of the event organizer.
color optional string	Color for the event series.
format optional number	Format of the description (0=plain, 1=markdown, 2=html).
max_attendees optional number	Maximum number of attendees per event.
rsvp optional boolean	Whether RSVP is required.
additional_guests optional boolean	Whether attendees can bring guests.
send_notice optional boolean	Whether to send a notice about the events.
yes_message optional string	Message shown when RSVP is yes.
comment_label optional string	Label for the comment field.
reminder_interval optional number (multiple)	Array of reminder intervals. The amount of time before each event occurrence to send the reminder.
reminder_type optional string (multiple)	Array of reminder types. Values: "reminder_type_minutes", "reminder_type_hours", "reminder_type_days", "reminder_type_weeks".
reminder_special optional string (multiple)	Array of special notice flags. Set to "true" to send as special notice, omit for regular reminder.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information.

Setting Reminders for Recurring Events

Reminders apply to all occurrences in the series:

reminder_interval[0]=15&reminder_type[0]=reminder_type_minutes (15 minutes before each occurrence)
reminder_interval[1]=1&reminder_type[1]=reminder_type_hours (1 hour before each occurrence)
reminder_interval[2]=1&reminder_type[2]=reminder_type_days&reminder_special[2]=true (1 day before, special notice)

Returns

Returns the created repeat event object. Returns an error if parameters are invalid.

Additional Errors

"bad_request"	"invalid subscription" is returned if the user is not subscribed to the group.
"bad_request"	"invalid group" is returned if the group is invalid.
"bad_request"	"no permission" is returned if the user doesn't have calendar management permissions.

POST /api/v1/addrepeatevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/addrepeatevent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "duration=3600" \
  -d "fri=true" \
  -d "group_id=12" \
  -d "mon=true" \
  -d "name=Team%20Sync" \
  -d "reminder_interval[0]=1" \
  -d "reminder_type[0]=reminder_type_hours" \
  -d "repeat_ends=0" \
  -d "repeat_interval=1" \
  -d "repeat_type=2" \
  -d "start_time=2024-01-15T14:00:00Z" \
  -d "timezone=America/New_York" \
  -d "wed=true"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("duration", "3600")
    data.Set("fri", "true")
    data.Set("group_id", "12")
    data.Set("mon", "true")
    data.Set("name", "Team%20Sync")
    data.Set("reminder_interval[0]", "1")
    data.Set("reminder_type[0]", "reminder_type_hours")
    data.Set("repeat_ends", "0")
    data.Set("repeat_interval", "1")
    data.Set("repeat_type", "2")
    data.Set("start_time", "2024-01-15T14:00:00Z")
    data.Set("timezone", "America/New_York")
    data.Set("wed", "true")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/addrepeatevent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'duration': '3600',
            'fri': 'true',
            'group_id': '12',
            'mon': 'true',
            'name': 'Team%20Sync',
            'reminder_interval[0]': '1',
            'reminder_type[0]': 'reminder_type_hours',
            'repeat_ends': '0',
            'repeat_interval': '1',
            'repeat_type': '2',
            'start_time': '2024-01-15T14:00:00Z',
            'timezone': 'America/New_York',
            'wed': 'true'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/addrepeatevent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 58,
 "object": "event",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "creator_name": "@JohnSmith",
 "group_id": 36,
 "group_name": "",
 "nice_group_name": "",
 "start_time": "2009-11-10T15:00:00-08:00",
 "end_time": "2009-11-10T15:00:00-08:00",
 "timezone": "",
 "all_day": false,
 "name": "",
 "location": "",
 "description": "",
 "organizer_name": "",
 "organizer_email": "",
 "organizer_phone": "",
 "color_name": "color_antique_pink",
 "color_hex": "",
 "rsvp": false,
 "max_attendees": 1,
 "additional_guests": false,
 "comment_label": "",
 "yes_message": "",
 "has_rsvp": false,
 "rsvp_type": "",
 "rsvp_comment": "",
 "rsvp_additional_guests": 30,
}

View Event definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Event

Delete an event.

Permissions Needed

You must have calendar management permissions for the group or be the event creator.

POST Parameters

event_id required number	ID of the event to delete.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information.

Returns

Returns success status. Returns an error if parameters are invalid.

Additional Errors

"bad_request"	"invalid event_id" is returned if the event id is missing or invalid.
"bad_request"	"no permission" is returned if the user doesn't have permission to delete the event.

POST /api/v1/deleteevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deleteevent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "event_id=123"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("event_id", "123")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deleteevent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'event_id': '123'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deleteevent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "success",
 "extra": "",
}

View Success definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Repeat Event

Update a repeating event series.

Permissions Needed

You must have calendar management permissions for the group or be the event creator.

POST Parameters

repeat_event_id required number	ID of the repeat event to update.
name required string	Name of the event.
description optional string	Description of the event.
location optional string	Location of the event.
start_time required string	Start time in RFC3339 format.
end_time required string	End time in RFC3339 format.
timezone required string	Timezone for the event (e.g., "America/New_York").
all_day optional boolean	Whether this is an all-day event.
repeat_type required number	Type of repeat (1=daily, 2=weekly, 3=monthly, 4=yearly).
repeat_interval optional number	Interval for repeating (e.g., every 2 weeks).
repeat_ends required number	How the repeat ends (0=never, 1=date, 2=times).
repeat_until optional string	End date for repeating events (required if repeat_ends=1).
repeat_times optional number	Number of times to repeat (required if repeat_ends=2).
sun, mon, tue, wed, thu, fri, sat optional boolean	Days of week for weekly repeats.
month_type optional number	Type of monthly repeat (0=day of month, 1=week of month).
organizer_name optional string	Name of the event organizer.
organizer_email optional string	Email of the event organizer.
organizer_phone optional string	Phone of the event organizer.
color optional string	Color for the event.
format optional number	Format of the description (0=plain, 1=markdown, 2=html).
max_attendees optional number	Maximum number of attendees.
rsvp optional boolean	Whether RSVP is required.
additional_guests optional boolean	Whether attendees can bring guests.
send_notice optional boolean	Whether to send a notice about the event.
yes_message optional string	Message shown when RSVP is yes.
comment_label optional string	Label for the comment field.
reminder_interval optional number (multiple)	Array of reminder intervals. The amount of time before each event occurrence to send the reminder.
reminder_type optional string (multiple)	Array of reminder types. Values: "reminder_type_minutes", "reminder_type_hours", "reminder_type_days", "reminder_type_weeks".
reminder_special optional string (multiple)	Array of special notice flags. Set to "true" to send as special notice, omit for regular reminder.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information.

Updating Reminders for Repeating Events

When updating reminders for a series, the new reminders apply to all future occurrences:

reminder_interval[0]=15&reminder_type[0]=reminder_type_minutes (15 minutes before each occurrence)
reminder_interval[1]=1&reminder_type[1]=reminder_type_hours (1 hour before each occurrence)
Reminders are automatically recalculated for all instances in the series
To remove all reminders, omit the reminder parameters entirely

Returns

Returns success status. Returns an error if parameters are invalid.

Additional Errors

"bad_request"	"invalid repeat_event_id" is returned if the repeat event id is missing or invalid.
"bad_request"	"no permission" is returned if the user doesn't have permission to update the event.
"bad_request"	"no days selected" is returned for weekly repeats with no days selected.

POST /api/v1/updaterepeatevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updaterepeatevent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "end_time=2024-01-15T11:00:00Z" \
  -d "fri=true" \
  -d "mon=true" \
  -d "name=Weekly%20Meeting" \
  -d "repeat_ends=0" \
  -d "repeat_event_id=123" \
  -d "repeat_interval=1" \
  -d "repeat_type=2" \
  -d "start_time=2024-01-15T10:00:00Z" \
  -d "timezone=America/New_York" \
  -d "wed=true"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("end_time", "2024-01-15T11:00:00Z")
    data.Set("fri", "true")
    data.Set("mon", "true")
    data.Set("name", "Weekly%20Meeting")
    data.Set("repeat_ends", "0")
    data.Set("repeat_event_id", "123")
    data.Set("repeat_interval", "1")
    data.Set("repeat_type", "2")
    data.Set("start_time", "2024-01-15T10:00:00Z")
    data.Set("timezone", "America/New_York")
    data.Set("wed", "true")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updaterepeatevent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'end_time': '2024-01-15T11:00:00Z',
            'fri': 'true',
            'mon': 'true',
            'name': 'Weekly%20Meeting',
            'repeat_ends': '0',
            'repeat_event_id': '123',
            'repeat_interval': '1',
            'repeat_type': '2',
            'start_time': '2024-01-15T10:00:00Z',
            'timezone': 'America/New_York',
            'wed': 'true'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updaterepeatevent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "success",
 "extra": "",
}

View Success definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Repeat Event

Delete a repeating event series.

Permissions Needed

You must have calendar management permissions for the group or be the event creator.

POST Parameters

repeat_event_id required number	ID of the repeat event to delete.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information.

Returns

Returns success status. Returns an error if parameters are invalid.

Additional Errors

"bad_request"	"invalid repeat_event_id" is returned if the repeat event id is missing or invalid.
"bad_request"	"no permission" is returned if the user doesn't have permission to delete the event.

POST /api/v1/deleterepeatevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deleterepeatevent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "repeat_event_id=123"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("repeat_event_id", "123")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deleterepeatevent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'repeat_event_id': '123'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deleterepeatevent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "success",
 "extra": "",
}

View Success definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Split Repeat Event

Split a repeating event series at a specific point ("This and Future" functionality).

Permissions Needed

You must have calendar management permissions for the group or be the event creator.

POST Parameters

repeat_event_id required number	ID of the repeat event to split.
split_time required string	ISO 8601 timestamp where to split the series.
name required string	Name of the new event series.
description optional string	Description of the new event series.
location optional string	Location of the new event series.
timezone optional string	Timezone of the new event series.
organizer_name optional string	Organizer name for the new series.
organizer_email optional string	Organizer email for the new series.
organizer_phone optional string	Organizer phone for the new series.
yes_message optional string	RSVP yes message for the new series.
comment_label optional string	Comment label for the new series.
color optional string	Color of the new event series.
format optional number	Format type for the new event series.
max_attendees optional number	Maximum attendees for the new series.
all_day optional boolean	Whether the new series is all day.
rsvp optional boolean	Whether RSVP is enabled for the new series.
additional_guests optional boolean	Whether additional guests are allowed.
send_notice optional boolean	Whether to send notices for the new series.
start_time required string	ISO 8601 start time for the new series.
duration required number	Duration in seconds for the new series.
type required string	Type of repeat pattern (daily, weekly, monthly, yearly).
frequency required number	Repeat every N days/weeks/months/years.
sun, mon, tue, wed, thu, fri, sat optional boolean	For weekly repeats, which days.
monthly_type optional string	For monthly repeats, the type (day_of_month, day_of_week).
repeat_ends required string	How the new series ends (never, date, times).
repeat_until optional string	ISO 8601 end date if repeat_ends is "date".
repeat_times optional number	Number of occurrences if repeat_ends is "times".
reminder_interval optional number (multiple)	Array of reminder intervals for the new series. The amount of time before each event occurrence to send the reminder.
reminder_type optional string (multiple)	Array of reminder types for the new series. Values: "reminder_type_minutes", "reminder_type_hours", "reminder_type_days", "reminder_type_weeks".
reminder_special optional string (multiple)	Array of special notice flags for the new series. Set to "1" to send as special notice, "0" or omit for regular reminder.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information.

Splitting Series with Different Reminders

When splitting a series, you can set different reminders for the new series:

The original series keeps its existing reminders up to the split point
The new series uses the reminders specified in the request
Example: Split a daily meeting to change from 15-minute reminders to 1-hour reminders
- reminder_interval[0]=1&reminder_type[0]=reminder_type_hours (1 hour before each future occurrence)

Returns

Returns the created repeat event. Returns an error if parameters are invalid.

Additional Errors

"bad_request"	"invalid repeat_event_id" is returned if the repeat event id is missing or invalid.
"bad_request"	"no permission" is returned if the user doesn't have permission to split the event.
"bad_request"	"invalid split_time" is returned if the split time is invalid.

POST /api/v1/splitrepeatevent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/splitrepeatevent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "duration=3600" \
  -d "frequency=1" \
  -d "name=Modified%20Meeting" \
  -d "repeat_ends=never" \
  -d "repeat_event_id=123" \
  -d "split_time=2024-01-10T09:00:00Z" \
  -d "start_time=2024-01-10T10:00:00Z" \
  -d "type=daily"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("duration", "3600")
    data.Set("frequency", "1")
    data.Set("name", "Modified%20Meeting")
    data.Set("repeat_ends", "never")
    data.Set("repeat_event_id", "123")
    data.Set("split_time", "2024-01-10T09:00:00Z")
    data.Set("start_time", "2024-01-10T10:00:00Z")
    data.Set("type", "daily")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/splitrepeatevent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'duration': '3600',
            'frequency': '1',
            'name': 'Modified%20Meeting',
            'repeat_ends': 'never',
            'repeat_event_id': '123',
            'split_time': '2024-01-10T09:00:00Z',
            'start_time': '2024-01-10T10:00:00Z',
            'type': 'daily'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/splitrepeatevent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 46,
 "object": "event",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "creator_name": "@JohnSmith",
 "group_id": 54,
 "group_name": "",
 "nice_group_name": "",
 "start_time": "2009-11-10T15:00:00-08:00",
 "end_time": "2009-11-10T15:00:00-08:00",
 "timezone": "",
 "all_day": false,
 "name": "",
 "location": "",
 "description": "",
 "organizer_name": "",
 "organizer_email": "",
 "organizer_phone": "",
 "color_name": "color_antique_pink",
 "color_hex": "",
 "rsvp": false,
 "max_attendees": 38,
 "additional_guests": false,
 "comment_label": "",
 "yes_message": "",
 "has_rsvp": false,
 "rsvp_type": "",
 "rsvp_comment": "",
 "rsvp_additional_guests": 8,
}

View Event definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Feed

Get the list of feeds associated with the logged in user. Feed objects are returned using the pagination request and object format.

Query Parameters

extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

GET /api/v1/getfeed
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getfeed?limit=2&page_token=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getfeed?limit=2&page_token=1", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getfeed');
    url.searchParams.append('limit', '2');
    url.searchParams.append('page_token', '1');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 53,
 "start_item": 16,
 "end_item": 3,
 "has_more": false,
 "next_page_token": 8,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "object": "feed",
    "member_info": 
      {
         "id": 93846546,
         "object": "member_info",
         "created": "2020-09-09T04:11:00-07:00",
         "updated": "2022-06-08T07:16:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "group_name": "StrategyHub",
         "status": "sub_status_normal",
         "post_status": "sub_poststatus_newusermoderated",
         "email_delivery": "email_delivery_digest",
         "message_selection": "message_selection_follow_and_first_message",
         "auto_follow_replies": false,
         "max_attachment_size": "max_attachment_size_medium",
         "approved_posts": 0,
         "mod_status": "sub_modstatus_owner",
         "pending_msg_notify": "sub_notify_email_and_app",
         "pending_sub_notify": "sub_notify_email_and_app",
         "sub_notify": "sub_notify_email_and_app",
         "storage_notify": "sub_notify_email_and_app",
         "sub_group_notify": "sub_notify_email_and_app",
         "message_report_notify": "sub_notify_email_and_app",
         "account_notify": "sub_notify_email_and_app",
         "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
         "owner_msg_notify": "sub_ownermsg_notify_subs",
         "chat_notify": "sub_notify_email_and_app",
         "photo_notify": "sub_notify_email_and_app",
         "file_notify": "sub_notify_email_and_app",
         "wiki_notify": "sub_notify_email_and_app",
         "database_notify": "sub_notify_email_and_app",
         "email": "gersonbeahan@jacobi.io",
         "user_status": "user_status_confirmed",
         "user_name": "Dickens6041",
         "timezone": "America/Chicago",
         "full_name": "Lawson Kreiger",
         "about_me": "Today awfully arrive at",
         "location": "Well away onto",
         "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "profile_privacy": "profile_private",
         "dont_munge_message_id": false,
         "use_signature": false,
         "use_signature_email": false,
         "signature": "In hotel furniture anyone weakly besides",
         "color": "color_cerulean_blue",
         "cover_photo_url": "",
         "icon_url": "",
         "nice_group_name": "",
         "subs_count": 0,
         "most_recent_message": "0001-01-01T00:00:00Z",
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "member_labels": [
           {
             "id": 726,
             "object": "memberlabel",
             "created": "2020-09-29T22:19:00Z",
             "group_id": 1857,
             "name": "Florida",
             "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
             "color_name": "green-sage",
             "color_hex": "#9fc4ac"
           },
           {
             "id": 1594,
             "object": "memberlabel",
             "created": "2020-09-24T02:24:00Z",
             "group_id": 42,
             "name": "Russel",
             "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
             "color_name": "purple",
             "color_hex": "#837fd5"
           },
           {
             "id": 1189,
             "object": "memberlabel",
             "created": "2020-09-12T02:11:00Z",
             "group_id": 1474,
             "name": "Meta",
             "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
             "color_name": "sky",
             "color_hex": "#9cc7df"
           }
         ],
         "extra_member_data": [
           {
             "col_id": 48876437,
             "col_type": "text_column",
             "text": "To firstly unlock while host himself me purely as whose."
           },
           {
             "col_id": 161476183,
             "col_type": "paragraph_column",
             "text": "Yet few mustering example will addition yearly since in these."
           },
           {
             "col_id": 39354277,
             "col_type": "checkbox_column",
             "checked": false
           },
           {
             "col_id": 8897324,
             "col_type": "multiple_choice_column",
             "multi_choice": [
               0
             ]
           },
           {
             "col_id": 159828550,
             "col_type": "date_column",
             "date": "1916-10-16T17:57:55.797000001Z"
           },
           {
             "col_id": 185149472,
             "col_type": "time_column",
             "time": "1919-03-30T18:00:36.790929649Z"
           },
           {
             "col_id": 166814414,
             "col_type": "address_column",
             "street_address1": "Premier Medical Group",
             "street_address2": "3701 DAUPHIN ST",
             "city": "MOBILE",
             "state": "AL",
             "zip": "36608-1756",
             "lat": 30.6866076,
             "lng": -88.13019249999999
           },
           {
             "col_id": 102385421,
             "col_type": "multi_choice_column",
             "multi_choice": [
               0,
               1,
               2
             ]
           },
           {
             "col_id": 154317202,
             "col_type": "link_column",
             "title": "To say poorly out according abundant unless nervously string lastly.",
             "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
             "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
           },
           {
             "col_id": 123191768,
             "col_type": "image_column",
             "url": "https://picsum.photos/id/27/187/110",
             "image_name": "Lately blazer with wild hourly there she it infrequently power."
           },
           {
             "col_id": 53386358,
             "col_type": "html_paragraph_column",
             "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
           },
           {
             "col_id": 45812071,
             "col_type": "email_column",
             "text": "brantkozey@bernhard.com"
           }
         ]
      },
    "group": 
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      },
    "topics": [
      {
       "topic": 
         {
            "id": 52691321,
            "object": "topic",
            "created": "2020-09-15T02:30:00-07:00",
            "updated": "2021-03-01T18:07:00-08:00",
            "group_id": 8658933,
            "group_subject_tag": "[StrategyHub]",
            "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
            "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
            "name": "Elenor Schaefer",
            "profile_photo_url": "",
            "num_messages": 22,
            "is_sticky": false,
            "is_moderated": false,
            "is_closed": false,
            "has_attachments": false,
            "reply_to": "thread_reply_group_default",
            "most_recent_message": "2020-09-29T17:03:00-07:00",
            "hashtags": null
         },
       "images": [
         {
          "id": "",
          "object": "attachment",
          "created": "2009-11-10T15:00:00-08:00",
          "group_id": 27,
          "user_id": 54,
          "thread_id": 59,
          "message_num": 57,
          "attach_num": 36,
          "type": "",
          "sub_type": "",
          "name": "",
          "content": "",
          "image_width": 21,
          "image_height": 13,
          "thumbnail_url": "",
         }
       ],
      }
    ],
    "events": [
      {
       "id": 71,
       "object": "event",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "creator_name": "@JohnSmith",
       "group_id": 93,
       "group_name": "",
       "nice_group_name": "",
       "start_time": "2009-11-10T15:00:00-08:00",
       "end_time": "2009-11-10T15:00:00-08:00",
       "timezone": "",
       "all_day": false,
       "name": "",
       "location": "",
       "description": "",
       "organizer_name": "",
       "organizer_email": "",
       "organizer_phone": "",
       "color_name": "color_antique_pink",
       "color_hex": "",
       "rsvp": false,
       "max_attendees": 30,
       "additional_guests": false,
       "comment_label": "",
       "yes_message": "",
       "has_rsvp": false,
       "rsvp_type": "",
       "rsvp_comment": "",
       "rsvp_additional_guests": 15,
      }
    ],
    "files": [
      {
         "id": 52691321,
         "object": "file",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "name": "Kelsi Ledner",
         "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
         "size": 132787700,
         "path": "topfolder/subfolder",
         "parent_folder_id": 0,
         "type": "file_type_file",
         "count": 2,
         "media_type": "text/plain",
         "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
         "display_name": "Lawson Kreiger",
         "user_name": "Dickens6041",
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "profile_privacy": "profile_private",
         "email": "gersonbeahan@..."
      }
    ],
    "photos": [
      {
         "id": 960,
         "object": "photo",
         "created": "2020-09-06T23:48:00-07:00",
         "updated": "2022-03-08T08:06:00-08:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "name": "Elegance joy group",
         "desc": "Senegalese whichever happen trade move outside downstairs of exemplified up. Out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for. Her our much nevertheless which numerous alone bevy as by. From e.g. otherwise laptop cloud then them yourselves few look.",
         "media_type": "image/jpg",
         "size": 2390440,
         "attachment_num": 0,
         "width": 0,
         "height": 0,
         "album_id": 52691321,
         "display_name": "Lawson Kreiger",
         "user_name": "Dickens6041",
         "profile_privacy": "profile_private",
         "email": "gersonbeahan@...",
         "format": "jpeg",
         "focal_length": 0,
         "iso": 0,
         "aperture": 0,
         "shutter_speed": 0,
         "taken": 0,
         "make": "",
         "model": ""
      }
    ],
    "chats": [
      {
         "id": 52691321,
         "object": "chat",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "user_id": 147779411,
         "profile_photo_url": "",
         "name": "",
         "can_view_profile": false,
         "group_id": 8658933,
         "subject": "Including.",
         "desc": "Tribe anything from.",
         "is_closed": false,
         "num_messages": 21,
         "chat_sub": {
           "id": 179889653,
           "object": "chat_sub",
           "created": "2020-09-10T11:42:00-07:00",
           "updated": "2023-03-29T23:48:00-07:00",
           "user_id": 147779411,
           "group_id": 8658933,
           "chat_id": 52691321,
           "last_msg_seen": 40
         }
      }
    ],
    "wikis": [
      {
         "id": 52691321,
         "object": "wiki_page",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "title": "Including tribe anything from whose market",
         "path": "Including-tribe-anything-from-whose-market",
         "locked": false,
         "rev_count": 43
      }
    ],
    "subgroups": [
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      }
    ],
    "tables": [
      {
       "id": 30,
       "object": "databasetable",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "group_id": 82,
       "user_id": 25,
       "name": "",
       "short_desc": "",
       "desc": "",
       "desc_type": "",
       "edit_table": "database_access_all",
       "edit_rows": "database_access_all",
       "add_rows": "database_access_all",
       "view_table": "database_access_all",
       "num_rows": 64,
       "max_row_id": 80,
       "num_columns": 72,
       "max_col_id": 98,
       "display_template": "",
       "columns": [
         {
            "id": 52691321,
            "name": "Multiple Choice: Including tribe anything from whose.",
            "type": "multiple_choice_column",
            "required": true,
            "color": "color_orchid",
            "choices": [
              "Next each secondly must catch politely.",
              "Sleepy where i.e. inquisitively yours wisp.",
              "Regularly nice cackle ourselves heavily now."
            ],
            "width": 0,
            "default_hidden": false,
            "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
         }
       ],
       "id_default_hidden": false,
       "updated_default_hidden": false,
      }
    ],
    "hashtags": [
      {
         "id": 541,
         "object": "hashtag",
         "created": "2020-09-17T11:22:00-07:00",
         "group_id": 1188,
         "name": "Karl",
         "mods_only_post": false,
         "mods_only_replies": false,
         "no_email": false,
         "moderated": false,
         "special": true,
         "replies_unmoderated": false,
         "locked": true,
         "until": "hashtag_delete_month",
         "close_instead_of_delete": true,
         "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
         "color_name": "pink",
         "color_hex": "#f39de4",
         "reply_to": "thread_reply_to_sender",
         "topic_count": 1789,
         "last_message_date": "2020-09-08T01:22:00-07:00",
         "muted": null,
         "followed": null
      }
    ],
   }
 ],
}

View Feed List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Single Feed

Get a single feed object for a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

GET /api/v1/getsinglefeed
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getsinglefeed?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getsinglefeed?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getsinglefeed');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "feed",
 "member_info": 
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   },
 "group": 
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   },
 "topics": [
   {
    "topic": 
      {
         "id": 52691321,
         "object": "topic",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "group_id": 8658933,
         "group_subject_tag": "[StrategyHub]",
         "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
         "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
         "name": "Elenor Schaefer",
         "profile_photo_url": "",
         "num_messages": 22,
         "is_sticky": false,
         "is_moderated": false,
         "is_closed": false,
         "has_attachments": false,
         "reply_to": "thread_reply_group_default",
         "most_recent_message": "2020-09-29T17:03:00-07:00",
         "hashtags": null
      },
    "images": [
      {
       "id": "",
       "object": "attachment",
       "created": "2009-11-10T15:00:00-08:00",
       "group_id": 92,
       "user_id": 2,
       "thread_id": 64,
       "message_num": 89,
       "attach_num": 26,
       "type": "",
       "sub_type": "",
       "name": "",
       "content": "",
       "image_width": 32,
       "image_height": 57,
       "thumbnail_url": "",
      }
    ],
   }
 ],
 "events": [
   {
    "id": 75,
    "object": "event",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "creator_name": "@JohnSmith",
    "group_id": 79,
    "group_name": "",
    "nice_group_name": "",
    "start_time": "2009-11-10T15:00:00-08:00",
    "end_time": "2009-11-10T15:00:00-08:00",
    "timezone": "",
    "all_day": false,
    "name": "",
    "location": "",
    "description": "",
    "organizer_name": "",
    "organizer_email": "",
    "organizer_phone": "",
    "color_name": "color_antique_pink",
    "color_hex": "",
    "rsvp": false,
    "max_attendees": 29,
    "additional_guests": false,
    "comment_label": "",
    "yes_message": "",
    "has_rsvp": false,
    "rsvp_type": "",
    "rsvp_comment": "",
    "rsvp_additional_guests": 67,
   }
 ],
 "files": [
   {
      "id": 52691321,
      "object": "file",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "name": "Kelsi Ledner",
      "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
      "size": 132787700,
      "path": "topfolder/subfolder",
      "parent_folder_id": 0,
      "type": "file_type_file",
      "count": 2,
      "media_type": "text/plain",
      "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
      "display_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "email": "gersonbeahan@..."
   }
 ],
 "photos": [
   {
      "id": 960,
      "object": "photo",
      "created": "2020-09-06T23:48:00-07:00",
      "updated": "2022-03-08T08:06:00-08:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "name": "Elegance joy group",
      "desc": "Senegalese whichever happen trade move outside downstairs of exemplified up. Out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for. Her our much nevertheless which numerous alone bevy as by. From e.g. otherwise laptop cloud then them yourselves few look.",
      "media_type": "image/jpg",
      "size": 2390440,
      "attachment_num": 0,
      "width": 0,
      "height": 0,
      "album_id": 52691321,
      "display_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "profile_privacy": "profile_private",
      "email": "gersonbeahan@...",
      "format": "jpeg",
      "focal_length": 0,
      "iso": 0,
      "aperture": 0,
      "shutter_speed": 0,
      "taken": 0,
      "make": "",
      "model": ""
   }
 ],
 "chats": [
   {
      "id": 52691321,
      "object": "chat",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "user_id": 147779411,
      "profile_photo_url": "",
      "name": "",
      "can_view_profile": false,
      "group_id": 8658933,
      "subject": "Including.",
      "desc": "Tribe anything from.",
      "is_closed": false,
      "num_messages": 21,
      "chat_sub": {
        "id": 179889653,
        "object": "chat_sub",
        "created": "2020-09-10T11:42:00-07:00",
        "updated": "2023-03-29T23:48:00-07:00",
        "user_id": 147779411,
        "group_id": 8658933,
        "chat_id": 52691321,
        "last_msg_seen": 40
      }
   }
 ],
 "wikis": [
   {
      "id": 52691321,
      "object": "wiki_page",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "title": "Including tribe anything from whose market",
      "path": "Including-tribe-anything-from-whose-market",
      "locked": false,
      "rev_count": 43
   }
 ],
 "subgroups": [
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   }
 ],
 "tables": [
   {
    "id": 35,
    "object": "databasetable",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 75,
    "user_id": 14,
    "name": "",
    "short_desc": "",
    "desc": "",
    "desc_type": "",
    "edit_table": "database_access_all",
    "edit_rows": "database_access_all",
    "add_rows": "database_access_all",
    "view_table": "database_access_all",
    "num_rows": 17,
    "max_row_id": 70,
    "num_columns": 67,
    "max_col_id": 83,
    "display_template": "",
    "columns": [
      {
         "id": 52691321,
         "name": "Multiple Choice: Including tribe anything from whose.",
         "type": "multiple_choice_column",
         "required": true,
         "color": "color_orchid",
         "choices": [
           "Next each secondly must catch politely.",
           "Sleepy where i.e. inquisitively yours wisp.",
           "Regularly nice cackle ourselves heavily now."
         ],
         "width": 0,
         "default_hidden": false,
         "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
      }
    ],
    "id_default_hidden": false,
    "updated_default_hidden": false,
   }
 ],
 "hashtags": [
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   }
 ],
}

View Feed definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

These are the API endpoints for directories and files.

Add Files

Add files or a folder of files.

Permissions Needed

You must have permission to add files to the folder.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
parent_folder_id required number	ID of the folder to add the files to, or 0 if the top-level.
desc optional string	Description of the file or of the folder.
fileupload required multipart file	Multipart file upload of one or more files.
is_folder optional boolean	If `true`, this is an upload of a folder.
file_path optional strings	If `is_folder` is true, for each file there should be a `file_path` variable, specifying the path of the file within the directory being uploaded.
notify optional boolean	If `true`, send a notification to the group.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns a file list object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid folder_id" is returned if the folder id is missing or invalid.
"bad_request"	"no space" is returned if the group is out of space.
"bad_request"	"file too big" is returned if the file is too large.
"bad_request"	"images not allowed" is returned if an image is uploaded to the files section of the group that does not allow images in the files section.
"bad_request"	"duplicate file" is returned if the name of the file matches another file in the same folder.

POST /api/v1/addfiles
cURL
Go
JavaScript

curl "https://groups.io/api/v1/addfiles" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/addfiles",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/addfiles', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "path": "",
   "files_percentage": 0,
   "files_gigs": "",
   "data": [
     {
       "id": 52691321,
       "object": "file",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Kelsi Ledner",
       "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
       "size": 132787700,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "file",
       "created": "2020-09-29T17:03:00-07:00",
       "updated": "2022-06-18T23:30:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Lilly Block",
       "desc": "Few why where win most would everybody them backwards this.",
       "size": 98233877,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/189377967/Lilly%20Block?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=H6FoD1Eh%2Br72mXAY6EY9fWWoBao%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 175712125,
       "object": "file",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Ludwig Douglas",
       "desc": "Mine year is ever what flock jealousy inside pod without.",
       "size": 197424827,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/175712125/Ludwig%20Douglas?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=J3IWI%2BNmeX3lNuAmgl9xAdDYs7k%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     }
   ]
}

View File List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Add Link

Add file link.

Permissions Needed

You must have permission to add a link to the folder.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
link_type required string	Type of the link. Can be: `google`, `dropbox`, `box`, `onedrive`, `generic`.
file_name required string	Name of the link.
url required string	The URL.
parent_folder_id required number	ID of the folder to add the link to, or 0 if the top-level.
desc optional string	Description of the link.
notify optional boolean	If `true`, send a notification to the group.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns a file object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid url" is returned if the URL is missing or invalid.
"bad_request"	"invalid file_name" is returned if the file_name is missing or invalid.
"bad_request"	"invalid parent_folder_id" is returned if the parent_folder_id is missing or invalid.
"bad_request"	"duplicate file" is returned if the name of the link matches another file in the same folder.

POST /api/v1/addfilelink
cURL
Go
JavaScript

curl "https://groups.io/api/v1/addfilelink" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/addfilelink",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/addfilelink', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "path": "",
   "files_percentage": 0,
   "files_gigs": "",
   "data": [
     {
       "id": 52691321,
       "object": "file",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Kelsi Ledner",
       "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
       "size": 132787700,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "file",
       "created": "2020-09-29T17:03:00-07:00",
       "updated": "2022-06-18T23:30:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Lilly Block",
       "desc": "Few why where win most would everybody them backwards this.",
       "size": 98233877,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/189377967/Lilly%20Block?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=H6FoD1Eh%2Br72mXAY6EY9fWWoBao%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 175712125,
       "object": "file",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Ludwig Douglas",
       "desc": "Mine year is ever what flock jealousy inside pod without.",
       "size": 197424827,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/175712125/Ludwig%20Douglas?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=J3IWI%2BNmeX3lNuAmgl9xAdDYs7k%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     }
   ]
}

View File List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get File Directory

Get file directory. Files and directories are returned using the pagination request and object format.

Permissions Needed

You must have the files_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
path optional string	Path to view. Path can either be empty or a folder.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are: `title`, `created`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a file list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

Notes

GET /api/v1/getfiledirectory
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getfiledirectory?group_id=12&path=%2FTop%2FNext" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getfiledirectory?group_id=12&path=%2FTop%2FNext", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getfiledirectory');
    url.searchParams.append('group_id', '12');
    url.searchParams.append('path', '%2FTop%2FNext');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "path": "",
   "files_percentage": 0,
   "files_gigs": "",
   "data": [
     {
       "id": 52691321,
       "object": "file",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Kelsi Ledner",
       "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
       "size": 132787700,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "file",
       "created": "2020-09-29T17:03:00-07:00",
       "updated": "2022-06-18T23:30:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Lilly Block",
       "desc": "Few why where win most would everybody them backwards this.",
       "size": 98233877,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/189377967/Lilly%20Block?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=H6FoD1Eh%2Br72mXAY6EY9fWWoBao%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 175712125,
       "object": "file",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Ludwig Douglas",
       "desc": "Mine year is ever what flock jealousy inside pod without.",
       "size": 197424827,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/175712125/Ludwig%20Douglas?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=J3IWI%2BNmeX3lNuAmgl9xAdDYs7k%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     }
   ]
}

View File List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get File

Get file.

Permissions Needed

You must have the files_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
path required string	Path to file to download.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a file object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

Notes

GET /api/v1/getfile
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getfile?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getfile?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getfile');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 52691321,
   "object": "file",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "name": "Kelsi Ledner",
   "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
   "size": 132787700,
   "path": "topfolder/subfolder",
   "parent_folder_id": 0,
   "type": "file_type_file",
   "count": 2,
   "media_type": "text/plain",
   "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@..."
}

View File definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Search Files

Search files. Files and directory matches are returned using the pagination request and object format.

Permissions Needed

You must have the files_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
q required string	Query string.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are: `title`, `created`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a file list object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid query" is returned if the query string is empty.

Notes

GET /api/v1/searchfiles
cURL
Go
JavaScript

curl "https://groups.io/api/v1/searchfiles?group_id=12&q=Search+Term" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/searchfiles?group_id=12&q=Search+Term", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/searchfiles');
    url.searchParams.append('group_id', '12');
    url.searchParams.append('q', 'Search+Term');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "path": "",
   "files_percentage": 0,
   "files_gigs": "",
   "data": [
     {
       "id": 52691321,
       "object": "file",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Kelsi Ledner",
       "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
       "size": 132787700,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "file",
       "created": "2020-09-29T17:03:00-07:00",
       "updated": "2022-06-18T23:30:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Lilly Block",
       "desc": "Few why where win most would everybody them backwards this.",
       "size": 98233877,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/189377967/Lilly%20Block?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=H6FoD1Eh%2Br72mXAY6EY9fWWoBao%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 175712125,
       "object": "file",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Ludwig Douglas",
       "desc": "Mine year is ever what flock jealousy inside pod without.",
       "size": 197424827,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/175712125/Ludwig%20Douglas?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=J3IWI%2BNmeX3lNuAmgl9xAdDYs7k%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     }
   ]
}

View File List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete File

Delete file.

Permissions Needed

You must have permission to edit a file.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
file_id required number	ID of the file to delete.
notify optional boolean	If `true`, send a notification to the group.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid url" is returned if the URL is missing or invalid.
"bad_request"	"invalid file_name" is returned if the file_name is missing or invalid.
"bad_request"	"invalid parent_folder_id" is returned if the parent_folder_id is missing or invalid.
"bad_request"	"duplicate file" is returned if the name of the link matches another file in the same folder.

POST /api/v1/deletefile
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletefile" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletefile",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletefile', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "path": "",
   "files_percentage": 0,
   "files_gigs": "",
   "data": [
     {
       "id": 52691321,
       "object": "file",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Kelsi Ledner",
       "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
       "size": 132787700,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "file",
       "created": "2020-09-29T17:03:00-07:00",
       "updated": "2022-06-18T23:30:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Lilly Block",
       "desc": "Few why where win most would everybody them backwards this.",
       "size": 98233877,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/189377967/Lilly%20Block?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=H6FoD1Eh%2Br72mXAY6EY9fWWoBao%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 175712125,
       "object": "file",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Ludwig Douglas",
       "desc": "Mine year is ever what flock jealousy inside pod without.",
       "size": 197424827,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/175712125/Ludwig%20Douglas?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=J3IWI%2BNmeX3lNuAmgl9xAdDYs7k%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     }
   ]
}

View File List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Create Group

Create a group.

Permissions Needed

None.

POST Parameters

group_name required string	Name of the new group.
desc required string	Description of the new group.
privacy required string	Privacy of the new group, one of `group_privacy_none`, `group_privacy_archives`, `group_privacy_unlisted`, `group_privacy_unlisted_public`
csrf required string	The `csrf_token` from the user object returned when first logged in.
accept_policies required boolean	Signals that you agree to comply with our Online Safety Policy and our Terms of Service. This must be set to `true`.
email_delivery optional string	Email delivery, can be `email_delivery_single`, `email_delivery_digest`, `email_delivery_special`, `email_delivery_none`, `email_delivery_html_digest`, `email_delivery_summary`
message_selection optional string	Message selection, can be `message_selection_all`, `message_selection_follow_only`, `message_selection_follow_and_first_message`
auto_follow_replies optional boolean
max_attachment_size optional string	Maximum attachment size, can be `max_attachment_size_unlimited`, `max_attachment_size_small`, `max_attachment_size_medium`, `max_attachment_size_large`, `max_attachment_size_none`
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the group object if the group is successfully created. Returns an error if parameters are invalid (e.g. specifying an invalid group_name). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_name" is returned if the group name is not a valid group name.
"bad_request"	"description too short" is returned if the group description is too short.
"bad_request"	"name already taken" is returned if a group with that name already exists.

Notes

A subscription is created for the user to the group with owner permissions. If email_delivery, message_selection, auto_follow_replies, or max_attachment_size is specified, the subscription will be created with those values.

POST /api/v1/creategroup
cURL
Go
JavaScript

curl "https://groups.io/api/v1/creategroup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "desc=This+is+my+group" \
  -d "group_name=apisubgroup" \
  -d "privacy=group_privacy_none"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("desc", "This+is+my+group")
    data.Set("group_name", "apisubgroup")
    data.Set("privacy", "group_privacy_none")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/creategroup",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'desc': 'This+is+my+group',
            'group_name': 'apisubgroup',
            'privacy': 'group_privacy_none'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/creategroup', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 8658933,
   "object": "group",
   "created": "2020-09-15T11:29:00-07:00",
   "updated": "2022-02-12T18:51:00-08:00",
   "type": "group_type_messages",
   "title": "",
   "name": "StrategyHub",
   "nice_group_name": "",
   "alias": "",
   "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
   "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
   "subject_tag": "[StrategyHub]",
   "footer": "This is my\nFooter!!!!",
   "website": "",
   "announce": false,
   "moderation": "moderated",
   "new_users_moderated": true,
   "unmoderate_users_after": 3,
   "restricted": true,
   "invite_only": false,
   "allow_non_subs_to_post": false,
   "force_html_emails": false,
   "normalize_html_emails": false,
   "reply_to": "group_reply_to_group",
   "remove_other_reply_options": false,
   "privacy": "group_privacy_none",
   "seperate_footers": false,
   "allow_downloads": "allow_downloads_by_members",
   "members_visible": "group_view_members_moderators",
   "sub_group_access": "sub_group_subs",
   "calendar_access": "group_access_subscribers",
   "files_access": "group_access_subscribers",
   "database_access": "group_access_subscribers",
   "wiki_access": "group_access_subscribers",
   "photos_access": "group_access_subscribers",
   "member_directory_access": "group_access_subscribers",
   "polls_access": "polls_access_subscribers",
   "chat_access": "group_access_subscribers",
   "handle_attachments": "group_attachments_normal",
   "plain_text_only": false,
   "handle_virus": "handle_virus_block",
   "locked": false,
   "plan": "group_plan_premium",
   "trial_group": false,
   "has_cover_photo": false,
   "has_icon": false,
   "parent_group_id": 0,
   "org_id": 1,
   "max_photo_size_email": "max_photo_size_none",
   "max_photo_size_photos": "max_photo_size_none",
   "max_photo_size_databases": "max_photo_size_none",
   "max_photo_size_wiki_images": "max_photo_size_none",
   "hash_tags_required": false,
   "hash_tag_permissions": "hash_tag_create_subs",
   "bounce_attachments": false,
   "allow_photos_in_files": false,
   "allow_reposts": false,
   "min_days_between_reposts": 0,
   "max_number_of_reposts": 0,
   "email_delivery_default": "email_delivery_single",
   "message_selection_default": "message_selection_all",
   "auto_follow_replies_default": false,
   "max_attachment_size_default": "max_attachment_size_small",
   "default_color": "color_cerulean_blue",
   "default_timezone": "America/Los_Angeles",
   "default_time_pref": "standard_time",
   "default_date_pref": "us_date",
   "default_monday_start": false,
   "disable_edits": false,
   "disable_no_email": false,
   "auto_close_threads": false,
   "close_threads_after": 0,
   "auto_moderate_threads": false,
   "moderate_threads_after": 0,
   "sticky_wiki_page_id": 0,
   "sub_group_categoryid": 0,
   "subs_count": 541,
   "pending_subs_count": 0,
   "pending_msgs_count": 0,
   "open_chats_count": 0,
   "threads_count": 0,
   "messages_count": 0,
   "org_domain": "",
   "most_recent_message": "2020-09-07T19:38:00-07:00",
   "cover_photo_url": "",
   "icon_url": "",
   "group_url": "",
   "allow_parent_subs_to_post": false,
   "send_event_summaries": false,
   "event_summary_schedule": "event_summary_weekly_friday",
   "send_invites_on_join": false,
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "email_address": "StrategyHub@groups.io",
   "extra_member_data_columns": [
     {
       "id": 48876437,
       "name": "Text: Lots write point week doctor.",
       "type": "text_column",
       "required": true,
       "color": "color_beige",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Movement whose also it vanish watch these to ever always."
     },
     {
       "id": 161476183,
       "name": "Paragraph: Other few covey range window.",
       "type": "paragraph_column",
       "required": true,
       "color": "color_light_brown",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Silence lastly had what outcome let while school pause up."
     },
     {
       "id": 39354277,
       "name": "Checkbox: Company freedom pout his throw.",
       "type": "checkbox_column",
       "required": true,
       "color": "color_orange",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Quarterly outfit faithful is often part whom these been hourly."
     },
     {
       "id": 8897324,
       "name": "Multiple Choice: Madagascan anyway should late yours.",
       "type": "multiple_choice_column",
       "required": true,
       "color": "color_orchid",
       "choices": [
         "Monthly ball upon almost everything dynasty.",
         "Behalf shall nearly this weekly for.",
         "Anywhere everybody over secondly then boat."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Besides pack when murder her had snore first in limp."
     },
     {
       "id": 159828550,
       "name": "Date: Which these bale nobody few.",
       "type": "date_column",
       "required": true,
       "color": "color_blush",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "How anyone these string life that who result lately yourselves."
     },
     {
       "id": 185149472,
       "name": "Time: Besides later whom for rarely.",
       "type": "time_column",
       "required": true,
       "color": "color_sage",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Each her ski ours host our as did they to."
     },
     {
       "id": 166814414,
       "name": "Address: Bravery where this as cloud.",
       "type": "address_column",
       "required": true,
       "color": "color_cucumber",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Inside since open most you that including fight murder cautiously."
     },
     {
       "id": 102385421,
       "name": "Multi Choice: Another what full her can.",
       "type": "multi_choice_column",
       "required": true,
       "color": "color_aquamute",
       "choices": [
         "Indeed besides motherhood in that nightly.",
         "Limit we kneel herself collect yourselves.",
         "Yourselves Norwegian this fear happily fruit."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Pout nature bike moreover from whoever afterwards myself mine to."
     },
     {
       "id": 154317202,
       "name": "Link: Bale sedge Christian would whose.",
       "type": "link_column",
       "required": true,
       "color": "color_military",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Hers pack rhythm that now whose her out infancy somebody."
     },
     {
       "id": 123191768,
       "name": "Image: Today scenic consequently ours eye.",
       "type": "image_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Other other abundant some anywhere this life nevertheless in next."
     },
     {
       "id": 53386358,
       "name": "HTML Paragraph: Nobody what today e.g. loss.",
       "type": "html_paragraph_column",
       "required": true,
       "color": "color_emerald_green",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Spite Philippine before throughout wander of as there next of."
     },
     {
       "id": 45812071,
       "name": "Email: That because am terribly many.",
       "type": "email_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Because anyone does you hungrily can several might who monthly."
     }
   ]
}

View Group definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Create Sub Group

Create a subgroup.

Permissions Needed

You must have the manage_subgroups permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
sub_group_name required string	Name of the new subgroup
desc required string	Description of the new subgroup
privacy required string	Privacy of the new subgroup, one of `sub_group_privacy_limited_archives`, `sub_group_privacy_archives`, `sub_group_privacy_unlisted`, `sub_group_privacy_none`
csrf required string	The `csrf_token` from the user object returned when first logged in.
accept_policies required boolean	Signals that you agree to comply with our Online Safety Policy and our Terms of Service. This must be set to `true`.
email_delivery optional string	Email delivery, can be `email_delivery_single`, `email_delivery_digest`, `email_delivery_special`, `email_delivery_none`, `email_delivery_html_digest`, `email_delivery_summary`
message_selection optional string	Message selection, can be `message_selection_all`, `message_selection_follow_only`, `message_selection_follow_and_first_message`
auto_follow_replies optional boolean
max_attachment_size optional string	Maximum attachment size, can be `max_attachment_size_unlimited`, `max_attachment_size_small`, `max_attachment_size_medium`, `max_attachment_size_large`, `max_attachment_size_none`
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the group object if the subgroup is successfully created. Returns an error if parameters are invalid (e.g. specifying an invalid sub_group_name). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_name" is returned if the group name is not a valid group nae.
"bad_request"	"description too short" is returned if the subgroup description is too short.
"bad_request"	"name already taken" is returned if a subgroup with that name already exists.
"bad_request"	"group is a subgroup" is returned if the `group_id` refers to a subgroup and not a parent group.
"bad_request"	"group does not support subgroups" is returned if the group is a free group.

Notes

A subscription is created for the user to the group with owner permissions. If email_delivery, message_selection, auto_follow_replies, or max_attachment_size is specified, the subscription will be created with those values.

POST /api/v1/createsubgroup
cURL
Go
JavaScript

curl "https://groups.io/api/v1/createsubgroup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "accept_policies=true" \
  -d "desc=This+is+my+subgroup" \
  -d "group_id=5" \
  -d "privacy=sub_group_privacy_none" \
  -d "sub_group_name=apisubgroup"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("accept_policies", "true")
    data.Set("desc", "This+is+my+subgroup")
    data.Set("group_id", "5")
    data.Set("privacy", "sub_group_privacy_none")
    data.Set("sub_group_name", "apisubgroup")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/createsubgroup",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'accept_policies': 'true',
            'desc': 'This+is+my+subgroup',
            'group_id': '5',
            'privacy': 'sub_group_privacy_none',
            'sub_group_name': 'apisubgroup'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/createsubgroup', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 8658933,
   "object": "group",
   "created": "2020-09-15T11:29:00-07:00",
   "updated": "2022-02-12T18:51:00-08:00",
   "type": "group_type_messages",
   "title": "",
   "name": "StrategyHub",
   "nice_group_name": "",
   "alias": "",
   "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
   "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
   "subject_tag": "[StrategyHub]",
   "footer": "This is my\nFooter!!!!",
   "website": "",
   "announce": false,
   "moderation": "moderated",
   "new_users_moderated": true,
   "unmoderate_users_after": 3,
   "restricted": true,
   "invite_only": false,
   "allow_non_subs_to_post": false,
   "force_html_emails": false,
   "normalize_html_emails": false,
   "reply_to": "group_reply_to_group",
   "remove_other_reply_options": false,
   "privacy": "group_privacy_none",
   "seperate_footers": false,
   "allow_downloads": "allow_downloads_by_members",
   "members_visible": "group_view_members_moderators",
   "sub_group_access": "sub_group_subs",
   "calendar_access": "group_access_subscribers",
   "files_access": "group_access_subscribers",
   "database_access": "group_access_subscribers",
   "wiki_access": "group_access_subscribers",
   "photos_access": "group_access_subscribers",
   "member_directory_access": "group_access_subscribers",
   "polls_access": "polls_access_subscribers",
   "chat_access": "group_access_subscribers",
   "handle_attachments": "group_attachments_normal",
   "plain_text_only": false,
   "handle_virus": "handle_virus_block",
   "locked": false,
   "plan": "group_plan_premium",
   "trial_group": false,
   "has_cover_photo": false,
   "has_icon": false,
   "parent_group_id": 0,
   "org_id": 1,
   "max_photo_size_email": "max_photo_size_none",
   "max_photo_size_photos": "max_photo_size_none",
   "max_photo_size_databases": "max_photo_size_none",
   "max_photo_size_wiki_images": "max_photo_size_none",
   "hash_tags_required": false,
   "hash_tag_permissions": "hash_tag_create_subs",
   "bounce_attachments": false,
   "allow_photos_in_files": false,
   "allow_reposts": false,
   "min_days_between_reposts": 0,
   "max_number_of_reposts": 0,
   "email_delivery_default": "email_delivery_single",
   "message_selection_default": "message_selection_all",
   "auto_follow_replies_default": false,
   "max_attachment_size_default": "max_attachment_size_small",
   "default_color": "color_cerulean_blue",
   "default_timezone": "America/Los_Angeles",
   "default_time_pref": "standard_time",
   "default_date_pref": "us_date",
   "default_monday_start": false,
   "disable_edits": false,
   "disable_no_email": false,
   "auto_close_threads": false,
   "close_threads_after": 0,
   "auto_moderate_threads": false,
   "moderate_threads_after": 0,
   "sticky_wiki_page_id": 0,
   "sub_group_categoryid": 0,
   "subs_count": 541,
   "pending_subs_count": 0,
   "pending_msgs_count": 0,
   "open_chats_count": 0,
   "threads_count": 0,
   "messages_count": 0,
   "org_domain": "",
   "most_recent_message": "2020-09-07T19:38:00-07:00",
   "cover_photo_url": "",
   "icon_url": "",
   "group_url": "",
   "allow_parent_subs_to_post": false,
   "send_event_summaries": false,
   "event_summary_schedule": "event_summary_weekly_friday",
   "send_invites_on_join": false,
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "email_address": "StrategyHub@groups.io",
   "extra_member_data_columns": [
     {
       "id": 48876437,
       "name": "Text: Lots write point week doctor.",
       "type": "text_column",
       "required": true,
       "color": "color_beige",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Movement whose also it vanish watch these to ever always."
     },
     {
       "id": 161476183,
       "name": "Paragraph: Other few covey range window.",
       "type": "paragraph_column",
       "required": true,
       "color": "color_light_brown",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Silence lastly had what outcome let while school pause up."
     },
     {
       "id": 39354277,
       "name": "Checkbox: Company freedom pout his throw.",
       "type": "checkbox_column",
       "required": true,
       "color": "color_orange",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Quarterly outfit faithful is often part whom these been hourly."
     },
     {
       "id": 8897324,
       "name": "Multiple Choice: Madagascan anyway should late yours.",
       "type": "multiple_choice_column",
       "required": true,
       "color": "color_orchid",
       "choices": [
         "Monthly ball upon almost everything dynasty.",
         "Behalf shall nearly this weekly for.",
         "Anywhere everybody over secondly then boat."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Besides pack when murder her had snore first in limp."
     },
     {
       "id": 159828550,
       "name": "Date: Which these bale nobody few.",
       "type": "date_column",
       "required": true,
       "color": "color_blush",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "How anyone these string life that who result lately yourselves."
     },
     {
       "id": 185149472,
       "name": "Time: Besides later whom for rarely.",
       "type": "time_column",
       "required": true,
       "color": "color_sage",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Each her ski ours host our as did they to."
     },
     {
       "id": 166814414,
       "name": "Address: Bravery where this as cloud.",
       "type": "address_column",
       "required": true,
       "color": "color_cucumber",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Inside since open most you that including fight murder cautiously."
     },
     {
       "id": 102385421,
       "name": "Multi Choice: Another what full her can.",
       "type": "multi_choice_column",
       "required": true,
       "color": "color_aquamute",
       "choices": [
         "Indeed besides motherhood in that nightly.",
         "Limit we kneel herself collect yourselves.",
         "Yourselves Norwegian this fear happily fruit."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Pout nature bike moreover from whoever afterwards myself mine to."
     },
     {
       "id": 154317202,
       "name": "Link: Bale sedge Christian would whose.",
       "type": "link_column",
       "required": true,
       "color": "color_military",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Hers pack rhythm that now whose her out infancy somebody."
     },
     {
       "id": 123191768,
       "name": "Image: Today scenic consequently ours eye.",
       "type": "image_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Other other abundant some anywhere this life nevertheless in next."
     },
     {
       "id": 53386358,
       "name": "HTML Paragraph: Nobody what today e.g. loss.",
       "type": "html_paragraph_column",
       "required": true,
       "color": "color_emerald_green",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Spite Philippine before throughout wander of as there next of."
     },
     {
       "id": 45812071,
       "name": "Email: That because am terribly many.",
       "type": "email_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Because anyone does you hungrily can several might who monthly."
     }
   ]
}

View Group definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Group Settings

Get the group settings

Permissions Needed

No permissions are needed, but some fields will not be returned if you do not have the proper permissions. For security reasons, you must specify a group_name to access information about a group that you are not subscribed to.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified, but `group_id` will be ignored if you are not subscribed to the group.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified, but `group_id` will be ignored if you are not subscribed to the group.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

GET /api/v1/getgroup
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getgroup?group_id=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getgroup?group_id=7", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getgroup');
    url.searchParams.append('group_id', '7');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 8658933,
   "object": "group",
   "created": "2020-09-15T11:29:00-07:00",
   "updated": "2022-02-12T18:51:00-08:00",
   "type": "group_type_messages",
   "title": "",
   "name": "StrategyHub",
   "nice_group_name": "",
   "alias": "",
   "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
   "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
   "subject_tag": "[StrategyHub]",
   "footer": "This is my\nFooter!!!!",
   "website": "",
   "announce": false,
   "moderation": "moderated",
   "new_users_moderated": true,
   "unmoderate_users_after": 3,
   "restricted": true,
   "invite_only": false,
   "allow_non_subs_to_post": false,
   "force_html_emails": false,
   "normalize_html_emails": false,
   "reply_to": "group_reply_to_group",
   "remove_other_reply_options": false,
   "privacy": "group_privacy_none",
   "seperate_footers": false,
   "allow_downloads": "allow_downloads_by_members",
   "members_visible": "group_view_members_moderators",
   "sub_group_access": "sub_group_subs",
   "calendar_access": "group_access_subscribers",
   "files_access": "group_access_subscribers",
   "database_access": "group_access_subscribers",
   "wiki_access": "group_access_subscribers",
   "photos_access": "group_access_subscribers",
   "member_directory_access": "group_access_subscribers",
   "polls_access": "polls_access_subscribers",
   "chat_access": "group_access_subscribers",
   "handle_attachments": "group_attachments_normal",
   "plain_text_only": false,
   "handle_virus": "handle_virus_block",
   "locked": false,
   "plan": "group_plan_premium",
   "trial_group": false,
   "has_cover_photo": false,
   "has_icon": false,
   "parent_group_id": 0,
   "org_id": 1,
   "max_photo_size_email": "max_photo_size_none",
   "max_photo_size_photos": "max_photo_size_none",
   "max_photo_size_databases": "max_photo_size_none",
   "max_photo_size_wiki_images": "max_photo_size_none",
   "hash_tags_required": false,
   "hash_tag_permissions": "hash_tag_create_subs",
   "bounce_attachments": false,
   "allow_photos_in_files": false,
   "allow_reposts": false,
   "min_days_between_reposts": 0,
   "max_number_of_reposts": 0,
   "email_delivery_default": "email_delivery_single",
   "message_selection_default": "message_selection_all",
   "auto_follow_replies_default": false,
   "max_attachment_size_default": "max_attachment_size_small",
   "default_color": "color_cerulean_blue",
   "default_timezone": "America/Los_Angeles",
   "default_time_pref": "standard_time",
   "default_date_pref": "us_date",
   "default_monday_start": false,
   "disable_edits": false,
   "disable_no_email": false,
   "auto_close_threads": false,
   "close_threads_after": 0,
   "auto_moderate_threads": false,
   "moderate_threads_after": 0,
   "sticky_wiki_page_id": 0,
   "sub_group_categoryid": 0,
   "subs_count": 541,
   "pending_subs_count": 0,
   "pending_msgs_count": 0,
   "open_chats_count": 0,
   "threads_count": 0,
   "messages_count": 0,
   "org_domain": "",
   "most_recent_message": "2020-09-07T19:38:00-07:00",
   "cover_photo_url": "",
   "icon_url": "",
   "group_url": "",
   "allow_parent_subs_to_post": false,
   "send_event_summaries": false,
   "event_summary_schedule": "event_summary_weekly_friday",
   "send_invites_on_join": false,
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "email_address": "StrategyHub@groups.io",
   "extra_member_data_columns": [
     {
       "id": 48876437,
       "name": "Text: Lots write point week doctor.",
       "type": "text_column",
       "required": true,
       "color": "color_beige",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Movement whose also it vanish watch these to ever always."
     },
     {
       "id": 161476183,
       "name": "Paragraph: Other few covey range window.",
       "type": "paragraph_column",
       "required": true,
       "color": "color_light_brown",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Silence lastly had what outcome let while school pause up."
     },
     {
       "id": 39354277,
       "name": "Checkbox: Company freedom pout his throw.",
       "type": "checkbox_column",
       "required": true,
       "color": "color_orange",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Quarterly outfit faithful is often part whom these been hourly."
     },
     {
       "id": 8897324,
       "name": "Multiple Choice: Madagascan anyway should late yours.",
       "type": "multiple_choice_column",
       "required": true,
       "color": "color_orchid",
       "choices": [
         "Monthly ball upon almost everything dynasty.",
         "Behalf shall nearly this weekly for.",
         "Anywhere everybody over secondly then boat."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Besides pack when murder her had snore first in limp."
     },
     {
       "id": 159828550,
       "name": "Date: Which these bale nobody few.",
       "type": "date_column",
       "required": true,
       "color": "color_blush",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "How anyone these string life that who result lately yourselves."
     },
     {
       "id": 185149472,
       "name": "Time: Besides later whom for rarely.",
       "type": "time_column",
       "required": true,
       "color": "color_sage",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Each her ski ours host our as did they to."
     },
     {
       "id": 166814414,
       "name": "Address: Bravery where this as cloud.",
       "type": "address_column",
       "required": true,
       "color": "color_cucumber",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Inside since open most you that including fight murder cautiously."
     },
     {
       "id": 102385421,
       "name": "Multi Choice: Another what full her can.",
       "type": "multi_choice_column",
       "required": true,
       "color": "color_aquamute",
       "choices": [
         "Indeed besides motherhood in that nightly.",
         "Limit we kneel herself collect yourselves.",
         "Yourselves Norwegian this fear happily fruit."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Pout nature bike moreover from whoever afterwards myself mine to."
     },
     {
       "id": 154317202,
       "name": "Link: Bale sedge Christian would whose.",
       "type": "link_column",
       "required": true,
       "color": "color_military",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Hers pack rhythm that now whose her out infancy somebody."
     },
     {
       "id": 123191768,
       "name": "Image: Today scenic consequently ours eye.",
       "type": "image_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Other other abundant some anywhere this life nevertheless in next."
     },
     {
       "id": 53386358,
       "name": "HTML Paragraph: Nobody what today e.g. loss.",
       "type": "html_paragraph_column",
       "required": true,
       "color": "color_emerald_green",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Spite Philippine before throughout wander of as there next of."
     },
     {
       "id": 45812071,
       "name": "Email: That because am terribly many.",
       "type": "email_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Because anyone does you hungrily can several might who monthly."
     }
   ]
}

View Group definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Sub Groups

Get a group's subgroups.

Permissions Needed

You must have the manage_group_settings permission to use this call.

Query Parameters

group_id required number	ID of the parent group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the parent group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `created`, `name`.
sort_dir optional string	Sort direction. Can be `asc` or .
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

GET /api/v1/getsubgroups
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getsubgroups?group_id=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getsubgroups?group_id=5", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getsubgroups');
    url.searchParams.append('group_id', '5');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 94,
 "start_item": 11,
 "end_item": 23,
 "has_more": false,
 "next_page_token": 57,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   }
 ],
}

View Group List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Group

Update a group's settings.

Permissions Needed

You must have the manage_group_settings permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
title optional string	Title.
name optional string	New name for the group. If this is a subgroup, this needs to be of the form `parentName+subName`.
alias optional string	Alias.
desc optional string	Description.
subject_tag optional string	Subject tag.
footer optional string	Message footer.
website optional string	Website.
announce optional boolean
moderated optional boolean
new_users_moderated optional boolean
unmoderate_users_after optional number
restricted optional boolean
allow_non_subs_to_post optional boolean
force_html_emails optional boolean
normalize_html_emails optional boolean
reply_to optional string	Can be `group_reply_to_group`, `group_reply_to_sender`, `group_reply_to_moderators`, `group_reply_to_group_and_sender`
remove_other_reply_options optional boolean
privacy optional string	For a parent/stand alone group, can be `group_privacy_none`, `group_privacy_archives`, `group_privacy_unlisted`, `group_privacy_unlisted_public`. For a subgroup, can be `sub_group_privacy_limited_archives`, `sub_group_privacy_archives`, `sub_group_privacy_unlisted`, `sub_group_privacy_none`, `sub_group_privacy_unlisted_public_archives`.
members_visible optional string	Can be `group_view_members_subs`, `group_view_members_moderators`, `group_view_members_owners`
sub_group_access optional string	Who has permission to create sub groups. For groups with subgroups, only settable on the parent group. Possible values are: `sub_group_subs`, `sub_group_moderators`,`sub_group_owners`
calendar_access optional string	Can be `group_access_limited`, `group_access_subscribers`, `group_access_moderators_only`, `group_access_none`, `group_access_public`, `group_access_public_limited`
files_access optional string	Can be `group_access_limited`, `group_access_subscribers`, `group_access_moderators_only`, `group_access_none`
database_access optional string	Can be `group_access_limited`, `group_access_subscribers`, `group_access_moderators_only`, `group_access_none`
wiki_access optional string	Can be `group_access_limited`, `group_access_subscribers`, `group_access_moderators_only`, `group_access_none`, `group_access_public`, `group_access_public_limited`
photos_access optional string	Can be `group_access_limited`, `group_access_subscribers`, `group_access_moderators_only`, `group_access_none`
member_directory_access optional string	Can be `group_access_limited`, `group_access_moderators_only`, `group_access_none`
polls_access optional string	Can be `polls_access_subscribers`, `polls_access_limited`, `polls_access_none`
chat_access optional string	Can be `group_access_limited`, `group_access_subscribers`, `group_access_none`
handle_attachments optional string	Can be `group_attachments_normal`, `group_attachments_bounced`, `group_attachments_stripped`, `group_attachments_moderated`
handle_virus optional string	Can be: `handle_virus_block`, `handle_virus_moderate`
plain_text_only optional boolean
fig_leaf optional string	Can be `fig_leaf_archives`, `fig_leaf_none`
max_photo_size_email optional string	Can be `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_medium`, `max_photo_size_large`, `max_photo_size_ex_small`, `max_photo_size_medium_small`, `max_photo_size_somewhat_small`
max_photo_size_photos optional string	Can be `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_medium`, `max_photo_size_large`, `max_photo_size_ex_small`, `max_photo_size_medium_small`, `max_photo_size_somewhat_small`
max_photo_size_databases optional string	Can be `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_medium`, `max_photo_size_large`, `max_photo_size_ex_small`, `max_photo_size_medium_small`, `max_photo_size_somewhat_small`
max_photo_size_wiki_images optional string	Can be `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_medium`, `max_photo_size_large`, `max_photo_size_ex_small`, `max_photo_size_medium_small`, `max_photo_size_somewhat_small`
hash_tags_required optional boolean
hash_tag_permissions optional string	Can be: `hash_tag_create_subs`, `hash_tag_create_mods_bounce`, `hash_tag_create_mods_remove`
bounce_attachments optional boolean
allow_photos_in_files optional boolean
email_delivery_default optional string	Email delivery default, can be `email_delivery_single`, `email_delivery_digest`, `email_delivery_special`, `email_delivery_none`, `email_delivery_html_digest`, `email_delivery_summary`
message_selection_default optional string	Message selection, can be `message_selection_all`, `message_selection_follow_only`, `message_selection_follow_and_first_message`
auto_follow_replies_default optional boolean
max_attachment_size_default optional string	Maximum attachment size, can be `max_attachment_size_unlimited`, `max_attachment_size_small`, `max_attachment_size_medium`, `max_attachment_size_large`, `max_attachment_size_none`
default_color optional string	Default color for member subscriptions.
default_timezone optional string	Default timezone for new users. For groups with subgroups, only settable on the parent group. The timezone string should corresponding to a file in the IANA Time Zone database.
disable_edits optional boolean
disable_no_email optional boolean
auto_close_threads optional boolean
close_threads_after optional number
auto_moderate_threads optional boolean
moderate_threads_after optional number
allow_reposts optional boolean	If true, members can repost messages. Only used with premium and enterprise groups.
min_days_between_reposts optional number	The minimum number of days between reposts.
max_number_of_reposts optional number	The maximum number of times a member can repost their message.
allow_parent_subs_to_post optional boolean
send_event_summaries optional boolean	If `true`, and a premium group, a summary email of upcoming events is sent out regularly.
event_summary_schedule optional string	Can be `event_summary_weekly_friday`, `event_summary_monthly`, `event_summary_biweekly_friday`.
send_invites_on_join optional boolean	If `true`, and a premium group, invites to all calendar events will be sent to new users, and a set of cancel events will be sent to users when they leave.
lock_group optional boolean	If `true`, and a premium group, locks the group, preventing any additional changes.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the group object if the update succeeded. Returns an error if update parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

bad_request	"name exists" is returned if the group name is already taken.
bad_request	"invalid group_name" is returned if it's a bad group name.

Notes

A stand alone/parent group cannot have all the fields announce, restricted, moderated, and new_users_moderated all set to false. If you do this, new_users_moderated will automatically be set to true.
A stand alone/parent group with private archives cannot later be switched to having public archives.
A subgroup with archives that are private to the subgroup cannot be later switched to either public archives or to archives that are viewable by the parent group.
If disable_no_email is changed to true, any member subscriptions that were set to email_delivery_none will automatically be changed to email_delivery_special. Also if email_delivery_default is set to email_delivery_none, it will be changed to email_delivery_special.
If force_html_emails is changed to true, any member subscriptions that were set to email_delivery_digest will automatically be changed to email_delivery_html_digest. Also if email_delivery_default is set to email_delivery_digest, it will be changed to email_delivery_html_digest.
If a group has alias set, that field cannot be unset/set to blank.
If this is a subgroup, the name field has to be of the form ParentGroupName+SubGroupName.
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.

POST /api/v1/updategroup
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updategroup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "chat_access=group_access_limited" \
  -d "group_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("chat_access", "group_access_limited")
    data.Set("group_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updategroup",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'chat_access': 'group_access_limited',
            'group_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updategroup', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 8658933,
   "object": "group",
   "created": "2020-09-15T11:29:00-07:00",
   "updated": "2022-02-12T18:51:00-08:00",
   "type": "group_type_messages",
   "title": "",
   "name": "StrategyHub",
   "nice_group_name": "",
   "alias": "",
   "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
   "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
   "subject_tag": "[StrategyHub]",
   "footer": "This is my\nFooter!!!!",
   "website": "",
   "announce": false,
   "moderation": "moderated",
   "new_users_moderated": true,
   "unmoderate_users_after": 3,
   "restricted": true,
   "invite_only": false,
   "allow_non_subs_to_post": false,
   "force_html_emails": false,
   "normalize_html_emails": false,
   "reply_to": "group_reply_to_group",
   "remove_other_reply_options": false,
   "privacy": "group_privacy_none",
   "seperate_footers": false,
   "allow_downloads": "allow_downloads_by_members",
   "members_visible": "group_view_members_moderators",
   "sub_group_access": "sub_group_subs",
   "calendar_access": "group_access_subscribers",
   "files_access": "group_access_subscribers",
   "database_access": "group_access_subscribers",
   "wiki_access": "group_access_subscribers",
   "photos_access": "group_access_subscribers",
   "member_directory_access": "group_access_subscribers",
   "polls_access": "polls_access_subscribers",
   "chat_access": "group_access_subscribers",
   "handle_attachments": "group_attachments_normal",
   "plain_text_only": false,
   "handle_virus": "handle_virus_block",
   "locked": false,
   "plan": "group_plan_premium",
   "trial_group": false,
   "has_cover_photo": false,
   "has_icon": false,
   "parent_group_id": 0,
   "org_id": 1,
   "max_photo_size_email": "max_photo_size_none",
   "max_photo_size_photos": "max_photo_size_none",
   "max_photo_size_databases": "max_photo_size_none",
   "max_photo_size_wiki_images": "max_photo_size_none",
   "hash_tags_required": false,
   "hash_tag_permissions": "hash_tag_create_subs",
   "bounce_attachments": false,
   "allow_photos_in_files": false,
   "allow_reposts": false,
   "min_days_between_reposts": 0,
   "max_number_of_reposts": 0,
   "email_delivery_default": "email_delivery_single",
   "message_selection_default": "message_selection_all",
   "auto_follow_replies_default": false,
   "max_attachment_size_default": "max_attachment_size_small",
   "default_color": "color_cerulean_blue",
   "default_timezone": "America/Los_Angeles",
   "default_time_pref": "standard_time",
   "default_date_pref": "us_date",
   "default_monday_start": false,
   "disable_edits": false,
   "disable_no_email": false,
   "auto_close_threads": false,
   "close_threads_after": 0,
   "auto_moderate_threads": false,
   "moderate_threads_after": 0,
   "sticky_wiki_page_id": 0,
   "sub_group_categoryid": 0,
   "subs_count": 541,
   "pending_subs_count": 0,
   "pending_msgs_count": 0,
   "open_chats_count": 0,
   "threads_count": 0,
   "messages_count": 0,
   "org_domain": "",
   "most_recent_message": "2020-09-07T19:38:00-07:00",
   "cover_photo_url": "",
   "icon_url": "",
   "group_url": "",
   "allow_parent_subs_to_post": false,
   "send_event_summaries": false,
   "event_summary_schedule": "event_summary_weekly_friday",
   "send_invites_on_join": false,
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "email_address": "StrategyHub@groups.io",
   "extra_member_data_columns": [
     {
       "id": 48876437,
       "name": "Text: Lots write point week doctor.",
       "type": "text_column",
       "required": true,
       "color": "color_beige",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Movement whose also it vanish watch these to ever always."
     },
     {
       "id": 161476183,
       "name": "Paragraph: Other few covey range window.",
       "type": "paragraph_column",
       "required": true,
       "color": "color_light_brown",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Silence lastly had what outcome let while school pause up."
     },
     {
       "id": 39354277,
       "name": "Checkbox: Company freedom pout his throw.",
       "type": "checkbox_column",
       "required": true,
       "color": "color_orange",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Quarterly outfit faithful is often part whom these been hourly."
     },
     {
       "id": 8897324,
       "name": "Multiple Choice: Madagascan anyway should late yours.",
       "type": "multiple_choice_column",
       "required": true,
       "color": "color_orchid",
       "choices": [
         "Monthly ball upon almost everything dynasty.",
         "Behalf shall nearly this weekly for.",
         "Anywhere everybody over secondly then boat."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Besides pack when murder her had snore first in limp."
     },
     {
       "id": 159828550,
       "name": "Date: Which these bale nobody few.",
       "type": "date_column",
       "required": true,
       "color": "color_blush",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "How anyone these string life that who result lately yourselves."
     },
     {
       "id": 185149472,
       "name": "Time: Besides later whom for rarely.",
       "type": "time_column",
       "required": true,
       "color": "color_sage",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Each her ski ours host our as did they to."
     },
     {
       "id": 166814414,
       "name": "Address: Bravery where this as cloud.",
       "type": "address_column",
       "required": true,
       "color": "color_cucumber",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Inside since open most you that including fight murder cautiously."
     },
     {
       "id": 102385421,
       "name": "Multi Choice: Another what full her can.",
       "type": "multi_choice_column",
       "required": true,
       "color": "color_aquamute",
       "choices": [
         "Indeed besides motherhood in that nightly.",
         "Limit we kneel herself collect yourselves.",
         "Yourselves Norwegian this fear happily fruit."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Pout nature bike moreover from whoever afterwards myself mine to."
     },
     {
       "id": 154317202,
       "name": "Link: Bale sedge Christian would whose.",
       "type": "link_column",
       "required": true,
       "color": "color_military",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Hers pack rhythm that now whose her out infancy somebody."
     },
     {
       "id": 123191768,
       "name": "Image: Today scenic consequently ours eye.",
       "type": "image_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Other other abundant some anywhere this life nevertheless in next."
     },
     {
       "id": 53386358,
       "name": "HTML Paragraph: Nobody what today e.g. loss.",
       "type": "html_paragraph_column",
       "required": true,
       "color": "color_emerald_green",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Spite Philippine before throughout wander of as there next of."
     },
     {
       "id": 45812071,
       "name": "Email: That because am terribly many.",
       "type": "email_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Because anyone does you hungrily can several might who monthly."
     }
   ]
}

View Group definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Group

Delete a group or a subgroup.

Permissions Needed

You must have the delete_group permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
understand required string	The string "I understand".
csrf required string	The `csrf_token` from the user object returned when first logged in.
reason optional string	A reason for deleting the group.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an error if update parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

"bad_request"	"understand" is returned if the proper string isn't passed in with the understand POST parameter.

Notes

Delete is permanent.
If the group has subgroups, all subgroups are also deleted.
If the group is not a subgroup (ie is a parent group or a stand alone group), the group name will not be recycled for some time and cannot be used again.

POST /api/v1/deletegroup
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletegroup" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=2" \
  -d "understand=I+understand"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "2")
    data.Set("understand", "I+understand")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletegroup",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '2',
            'understand': 'I+understand'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletegroup', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Permissions

Return which permissions you have in a group. Each subscription grants a set of permissions in a group. The permissions are determined by a whether a subscription is a normal user, a moderator, or an owner, as well as the various group settings. Note: you do not need to be subscribed to the group.

Permissions Needed

None.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

GET /api/v1/getperms
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getperms?group_id=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getperms?group_id=7", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getperms');
    url.searchParams.append('group_id', '7');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "perms",
   "archives_visible": true,
   "polls_visible": true,
   "members_visible": true,
   "chat_visible": true,
   "calendar_visible": true,
   "files_visible": true,
   "database_visible": true,
   "photos_visible": true,
   "wiki_visible": true,
   "member_directory_visible": true,
   "hashtags_visible": true,
   "guidelines_visible": true,
   "subgroups_visible": true,
   "open_donations_visible": true,
   "sponsor_visible": true,
   "manage_subgroups": true,
   "ask_visible": true,
   "delete_group": true,
   "download_archives": true,
   "download_entire_group": true,
   "download_members": true,
   "view_activity": true,
   "create_hashtags": true,
   "manage_hashtags": true,
   "manage_integrations": true,
   "manage_group_settings": true,
   "make_moderator": true,
   "manage_member_subscription_options": true,
   "manage_pending_members": true,
   "remove_members": true,
   "ban_members": true,
   "manage_group_billing": true,
   "manage_group_payments": true,
   "edit_archives": true,
   "manage_pending_messages": true,
   "invite_members": true,
   "can_post": true,
   "can_reply": true,
   "can_vote": true,
   "manage_polls": true,
   "manage_photos": true,
   "manage_members": true,
   "manage_calendar": true,
   "manage_chats": true,
   "view_member_directory": true,
   "manage_files": true,
   "manage_wiki": true,
   "manage_subscription": true,
   "public_page": true,
   "sub_page": true,
   "mod_page": true,
   "can_ask": true
}

View Perms definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Group Aliases

Get a group's aliases.

Permissions Needed

You must have the manage_group_settings permission to use this call.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `created`, `name`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Notes

Aliases are only available for premium and enterprise groups.
The group that an alias points to is identified by the alias_group_id field in the Group Alias object returned.

GET /api/v1/getgroupaliases
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getgroupaliases?group_id=5" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getgroupaliases?group_id=5", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getgroupaliases');
    url.searchParams.append('group_id', '5');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 45,
 "start_item": 7,
 "end_item": 81,
 "has_more": false,
 "next_page_token": 0,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 94,
    "object": "groupalias",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "name": "example",
    "alias_group_id": 53,
   }
 ],
}

View Group Alias List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Add New Group Alias

Add a new group alias.

Permissions Needed

You must have the manage_group_settings permission to use this call. Also, the group having the alias added to must be a premium or enterprise group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
alias_name required string	Name of the alias to create.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the group object if the group is successfully created. Returns an error if parameters are invalid (e.g. specifying an invalid group_name). Below are the unique errors to this call.

Additional Errors

bad_request	"invalid alias_name" is returned if the alias name is not a valid group name.
bad_request	"basic group" is returned if the group is not a premium or enterprise group.

Notes

POST /api/v1/newgroupalias
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newgroupalias" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "alias_name=newalias" \
  -d "group_id=65"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("alias_name", "newalias")
    data.Set("group_id", "65")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newgroupalias",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'alias_name': 'newalias',
            'group_id': '65'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newgroupalias', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 8658933,
   "object": "group",
   "created": "2020-09-15T11:29:00-07:00",
   "updated": "2022-02-12T18:51:00-08:00",
   "type": "group_type_messages",
   "title": "",
   "name": "StrategyHub",
   "nice_group_name": "",
   "alias": "",
   "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
   "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
   "subject_tag": "[StrategyHub]",
   "footer": "This is my\nFooter!!!!",
   "website": "",
   "announce": false,
   "moderation": "moderated",
   "new_users_moderated": true,
   "unmoderate_users_after": 3,
   "restricted": true,
   "invite_only": false,
   "allow_non_subs_to_post": false,
   "force_html_emails": false,
   "normalize_html_emails": false,
   "reply_to": "group_reply_to_group",
   "remove_other_reply_options": false,
   "privacy": "group_privacy_none",
   "seperate_footers": false,
   "allow_downloads": "allow_downloads_by_members",
   "members_visible": "group_view_members_moderators",
   "sub_group_access": "sub_group_subs",
   "calendar_access": "group_access_subscribers",
   "files_access": "group_access_subscribers",
   "database_access": "group_access_subscribers",
   "wiki_access": "group_access_subscribers",
   "photos_access": "group_access_subscribers",
   "member_directory_access": "group_access_subscribers",
   "polls_access": "polls_access_subscribers",
   "chat_access": "group_access_subscribers",
   "handle_attachments": "group_attachments_normal",
   "plain_text_only": false,
   "handle_virus": "handle_virus_block",
   "locked": false,
   "plan": "group_plan_premium",
   "trial_group": false,
   "has_cover_photo": false,
   "has_icon": false,
   "parent_group_id": 0,
   "org_id": 1,
   "max_photo_size_email": "max_photo_size_none",
   "max_photo_size_photos": "max_photo_size_none",
   "max_photo_size_databases": "max_photo_size_none",
   "max_photo_size_wiki_images": "max_photo_size_none",
   "hash_tags_required": false,
   "hash_tag_permissions": "hash_tag_create_subs",
   "bounce_attachments": false,
   "allow_photos_in_files": false,
   "allow_reposts": false,
   "min_days_between_reposts": 0,
   "max_number_of_reposts": 0,
   "email_delivery_default": "email_delivery_single",
   "message_selection_default": "message_selection_all",
   "auto_follow_replies_default": false,
   "max_attachment_size_default": "max_attachment_size_small",
   "default_color": "color_cerulean_blue",
   "default_timezone": "America/Los_Angeles",
   "default_time_pref": "standard_time",
   "default_date_pref": "us_date",
   "default_monday_start": false,
   "disable_edits": false,
   "disable_no_email": false,
   "auto_close_threads": false,
   "close_threads_after": 0,
   "auto_moderate_threads": false,
   "moderate_threads_after": 0,
   "sticky_wiki_page_id": 0,
   "sub_group_categoryid": 0,
   "subs_count": 541,
   "pending_subs_count": 0,
   "pending_msgs_count": 0,
   "open_chats_count": 0,
   "threads_count": 0,
   "messages_count": 0,
   "org_domain": "",
   "most_recent_message": "2020-09-07T19:38:00-07:00",
   "cover_photo_url": "",
   "icon_url": "",
   "group_url": "",
   "allow_parent_subs_to_post": false,
   "send_event_summaries": false,
   "event_summary_schedule": "event_summary_weekly_friday",
   "send_invites_on_join": false,
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "email_address": "StrategyHub@groups.io",
   "extra_member_data_columns": [
     {
       "id": 48876437,
       "name": "Text: Lots write point week doctor.",
       "type": "text_column",
       "required": true,
       "color": "color_beige",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Movement whose also it vanish watch these to ever always."
     },
     {
       "id": 161476183,
       "name": "Paragraph: Other few covey range window.",
       "type": "paragraph_column",
       "required": true,
       "color": "color_light_brown",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Silence lastly had what outcome let while school pause up."
     },
     {
       "id": 39354277,
       "name": "Checkbox: Company freedom pout his throw.",
       "type": "checkbox_column",
       "required": true,
       "color": "color_orange",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Quarterly outfit faithful is often part whom these been hourly."
     },
     {
       "id": 8897324,
       "name": "Multiple Choice: Madagascan anyway should late yours.",
       "type": "multiple_choice_column",
       "required": true,
       "color": "color_orchid",
       "choices": [
         "Monthly ball upon almost everything dynasty.",
         "Behalf shall nearly this weekly for.",
         "Anywhere everybody over secondly then boat."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Besides pack when murder her had snore first in limp."
     },
     {
       "id": 159828550,
       "name": "Date: Which these bale nobody few.",
       "type": "date_column",
       "required": true,
       "color": "color_blush",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "How anyone these string life that who result lately yourselves."
     },
     {
       "id": 185149472,
       "name": "Time: Besides later whom for rarely.",
       "type": "time_column",
       "required": true,
       "color": "color_sage",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Each her ski ours host our as did they to."
     },
     {
       "id": 166814414,
       "name": "Address: Bravery where this as cloud.",
       "type": "address_column",
       "required": true,
       "color": "color_cucumber",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Inside since open most you that including fight murder cautiously."
     },
     {
       "id": 102385421,
       "name": "Multi Choice: Another what full her can.",
       "type": "multi_choice_column",
       "required": true,
       "color": "color_aquamute",
       "choices": [
         "Indeed besides motherhood in that nightly.",
         "Limit we kneel herself collect yourselves.",
         "Yourselves Norwegian this fear happily fruit."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Pout nature bike moreover from whoever afterwards myself mine to."
     },
     {
       "id": 154317202,
       "name": "Link: Bale sedge Christian would whose.",
       "type": "link_column",
       "required": true,
       "color": "color_military",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Hers pack rhythm that now whose her out infancy somebody."
     },
     {
       "id": 123191768,
       "name": "Image: Today scenic consequently ours eye.",
       "type": "image_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Other other abundant some anywhere this life nevertheless in next."
     },
     {
       "id": 53386358,
       "name": "HTML Paragraph: Nobody what today e.g. loss.",
       "type": "html_paragraph_column",
       "required": true,
       "color": "color_emerald_green",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Spite Philippine before throughout wander of as there next of."
     },
     {
       "id": 45812071,
       "name": "Email: That because am terribly many.",
       "type": "email_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Because anyone does you hungrily can several might who monthly."
     }
   ]
}

View Group definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Group Alias

Delete a group alias.

Permissions Needed

You must have the manage_group_settings permission to use this call.

POST Parameters

alias_group_id required numer	ID of the alias group object to delete. Either `alias_group_id` or `alias_group_name` must be specified.
alias_group_name required string	Name of the alias group object to delete. Either `alias_group_id` or `alias_group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the aliased group object if the alias is successfully deleted. Returns an error if parameters are invalid (e.g. specifying an invalid group_name). Below are the unique errors to this call.

Additional Errors

bad_request	"invalid alias_group_name" is returned if the alias name is not a valid alias.

Notes

POST /api/v1/deletegroupalias
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletegroupalias" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "alias_group_id=65"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("alias_group_id", "65")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletegroupalias",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'alias_group_id': '65'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletegroupalias', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 8658933,
   "object": "group",
   "created": "2020-09-15T11:29:00-07:00",
   "updated": "2022-02-12T18:51:00-08:00",
   "type": "group_type_messages",
   "title": "",
   "name": "StrategyHub",
   "nice_group_name": "",
   "alias": "",
   "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
   "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
   "subject_tag": "[StrategyHub]",
   "footer": "This is my\nFooter!!!!",
   "website": "",
   "announce": false,
   "moderation": "moderated",
   "new_users_moderated": true,
   "unmoderate_users_after": 3,
   "restricted": true,
   "invite_only": false,
   "allow_non_subs_to_post": false,
   "force_html_emails": false,
   "normalize_html_emails": false,
   "reply_to": "group_reply_to_group",
   "remove_other_reply_options": false,
   "privacy": "group_privacy_none",
   "seperate_footers": false,
   "allow_downloads": "allow_downloads_by_members",
   "members_visible": "group_view_members_moderators",
   "sub_group_access": "sub_group_subs",
   "calendar_access": "group_access_subscribers",
   "files_access": "group_access_subscribers",
   "database_access": "group_access_subscribers",
   "wiki_access": "group_access_subscribers",
   "photos_access": "group_access_subscribers",
   "member_directory_access": "group_access_subscribers",
   "polls_access": "polls_access_subscribers",
   "chat_access": "group_access_subscribers",
   "handle_attachments": "group_attachments_normal",
   "plain_text_only": false,
   "handle_virus": "handle_virus_block",
   "locked": false,
   "plan": "group_plan_premium",
   "trial_group": false,
   "has_cover_photo": false,
   "has_icon": false,
   "parent_group_id": 0,
   "org_id": 1,
   "max_photo_size_email": "max_photo_size_none",
   "max_photo_size_photos": "max_photo_size_none",
   "max_photo_size_databases": "max_photo_size_none",
   "max_photo_size_wiki_images": "max_photo_size_none",
   "hash_tags_required": false,
   "hash_tag_permissions": "hash_tag_create_subs",
   "bounce_attachments": false,
   "allow_photos_in_files": false,
   "allow_reposts": false,
   "min_days_between_reposts": 0,
   "max_number_of_reposts": 0,
   "email_delivery_default": "email_delivery_single",
   "message_selection_default": "message_selection_all",
   "auto_follow_replies_default": false,
   "max_attachment_size_default": "max_attachment_size_small",
   "default_color": "color_cerulean_blue",
   "default_timezone": "America/Los_Angeles",
   "default_time_pref": "standard_time",
   "default_date_pref": "us_date",
   "default_monday_start": false,
   "disable_edits": false,
   "disable_no_email": false,
   "auto_close_threads": false,
   "close_threads_after": 0,
   "auto_moderate_threads": false,
   "moderate_threads_after": 0,
   "sticky_wiki_page_id": 0,
   "sub_group_categoryid": 0,
   "subs_count": 541,
   "pending_subs_count": 0,
   "pending_msgs_count": 0,
   "open_chats_count": 0,
   "threads_count": 0,
   "messages_count": 0,
   "org_domain": "",
   "most_recent_message": "2020-09-07T19:38:00-07:00",
   "cover_photo_url": "",
   "icon_url": "",
   "group_url": "",
   "allow_parent_subs_to_post": false,
   "send_event_summaries": false,
   "event_summary_schedule": "event_summary_weekly_friday",
   "send_invites_on_join": false,
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "email_address": "StrategyHub@groups.io",
   "extra_member_data_columns": [
     {
       "id": 48876437,
       "name": "Text: Lots write point week doctor.",
       "type": "text_column",
       "required": true,
       "color": "color_beige",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Movement whose also it vanish watch these to ever always."
     },
     {
       "id": 161476183,
       "name": "Paragraph: Other few covey range window.",
       "type": "paragraph_column",
       "required": true,
       "color": "color_light_brown",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Silence lastly had what outcome let while school pause up."
     },
     {
       "id": 39354277,
       "name": "Checkbox: Company freedom pout his throw.",
       "type": "checkbox_column",
       "required": true,
       "color": "color_orange",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Quarterly outfit faithful is often part whom these been hourly."
     },
     {
       "id": 8897324,
       "name": "Multiple Choice: Madagascan anyway should late yours.",
       "type": "multiple_choice_column",
       "required": true,
       "color": "color_orchid",
       "choices": [
         "Monthly ball upon almost everything dynasty.",
         "Behalf shall nearly this weekly for.",
         "Anywhere everybody over secondly then boat."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Besides pack when murder her had snore first in limp."
     },
     {
       "id": 159828550,
       "name": "Date: Which these bale nobody few.",
       "type": "date_column",
       "required": true,
       "color": "color_blush",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "How anyone these string life that who result lately yourselves."
     },
     {
       "id": 185149472,
       "name": "Time: Besides later whom for rarely.",
       "type": "time_column",
       "required": true,
       "color": "color_sage",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Each her ski ours host our as did they to."
     },
     {
       "id": 166814414,
       "name": "Address: Bravery where this as cloud.",
       "type": "address_column",
       "required": true,
       "color": "color_cucumber",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Inside since open most you that including fight murder cautiously."
     },
     {
       "id": 102385421,
       "name": "Multi Choice: Another what full her can.",
       "type": "multi_choice_column",
       "required": true,
       "color": "color_aquamute",
       "choices": [
         "Indeed besides motherhood in that nightly.",
         "Limit we kneel herself collect yourselves.",
         "Yourselves Norwegian this fear happily fruit."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Pout nature bike moreover from whoever afterwards myself mine to."
     },
     {
       "id": 154317202,
       "name": "Link: Bale sedge Christian would whose.",
       "type": "link_column",
       "required": true,
       "color": "color_military",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Hers pack rhythm that now whose her out infancy somebody."
     },
     {
       "id": 123191768,
       "name": "Image: Today scenic consequently ours eye.",
       "type": "image_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Other other abundant some anywhere this life nevertheless in next."
     },
     {
       "id": 53386358,
       "name": "HTML Paragraph: Nobody what today e.g. loss.",
       "type": "html_paragraph_column",
       "required": true,
       "color": "color_emerald_green",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Spite Philippine before throughout wander of as there next of."
     },
     {
       "id": 45812071,
       "name": "Email: That because am terribly many.",
       "type": "email_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Because anyone does you hungrily can several might who monthly."
     }
   ]
}

View Group definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

New Hashtag

Create a new hashtag.

Permissions Needed

You must have the create_hashtags permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
name required string	Name of the hashtag, should begin with #.
description optional string	Description of the hashtag.
no_email optional boolean	If `true`, messages with this tag will not be emailed to the group.
reply_to required string	How replies to these messages are handled. Can be one of: `thread_reply_group_default`, `thread_reply_to_group`, `thread_reply_to_sender`, `thread_reply_to_moderators`, `thread_reply_to_group_and_sender`, `thread_reply_only_to_sender`
until required string	When set, tagged topics will automatically be deleted or locked after the specified time period. Can be one of: `hashtag_delete_forever`, `hashtag_delete_hour`, `hashtag_delete_day`, `hashtag_delete_week`, `hashtag_delete_month`, `hashtag_delete_three_months`, `hashtag_delete_six_months`, `hashtag_delete_year`
color required string	Color of the tag. Can be one of:
mods_only_post optional boolean	If `true`, only moderators can tag topics with this hashtag.
mods_only_replies optional boolean	If `true`, only moderators can reply to topics tagged with this hashtag.
close_instead optional boolean	If `true`, topics will be locked instead of deleted after the specified time period.
moderated optional boolean	If `true`, messages with this hashtag will be moderated.
locked optional boolean	If `true`, topics created with this hashtag will be locked immediately.
alias optional string	If specified, this hashtag is an alias of the named hashtag.
replies_unmoderated optional boolean	In moderated groups, if this is `true` replies to these messages are not moderated.
special optional boolean	If `true`, messages with this tag will be sent as special notices.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a chat object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid name" is returned if the name is missing or invalid.
"bad_request"	"name exists" is returned if a hashtag with that name already exists.
"bad_request"	"invalid reply_to" is returned if the reply_to is missing or invalid.
"bad_request"	"invalid until" is returned if the until is missing or invalid.
"bad_request"	"invalid color" is returned if the color is missing or invalid.

POST /api/v1/newhashtag
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newhashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "name=#Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("name", "#Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newhashtag",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'name': '#Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newhashtag', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 541,
   "object": "hashtag",
   "created": "2020-09-17T11:22:00-07:00",
   "group_id": 1188,
   "name": "Karl",
   "mods_only_post": false,
   "mods_only_replies": false,
   "no_email": false,
   "moderated": false,
   "special": true,
   "replies_unmoderated": false,
   "locked": true,
   "until": "hashtag_delete_month",
   "close_instead_of_delete": true,
   "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
   "color_name": "pink",
   "color_hex": "#f39de4",
   "reply_to": "thread_reply_to_sender",
   "topic_count": 1789,
   "last_message_date": "2020-09-08T01:22:00-07:00",
   "muted": null,
   "followed": null
}

View Hashtag definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Hashtag

Update an existing hashtag.

Permissions Needed

You must have the manage_hashtags permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
name required string	Name of the hashtag, should begin with #.
new_name optional string	New name of the hashtag, should begin with #.
description optional string	Description of the hashtag.
no_email optional boolean	If `true`, messages with this tag will not be emailed to the group.
reply_to optional string	How replies to these messages are handled. Can be one of: `thread_reply_group_default`, `thread_reply_to_group`, `thread_reply_to_sender`, `thread_reply_to_moderators`, `thread_reply_to_group_and_sender`, `thread_reply_only_to_sender`
until optional string	When set, tagged topics will automatically be deleted or locked after the specified time period. Can be one of: `hashtag_delete_forever`, `hashtag_delete_hour`, `hashtag_delete_day`, `hashtag_delete_week`, `hashtag_delete_month`, `hashtag_delete_three_months`, `hashtag_delete_six_months`, `hashtag_delete_year`
color optional string	Color of the tag. Can be one of:
mods_only_post optional boolean	If `true`, only moderators can tag topics with this hashtag.
mods_only_replies optional boolean	If `true`, only moderators can reply to topics tagged with this hashtag.
close_instead optional boolean	If `true`, topics will be locked instead of deleted after the specified time period.
moderated optional boolean	If `true`, messages with this hashtag will be moderated.
locked optional boolean	If `true`, topics created with this hashtag will be locked immediately.
alias optional string	If specified, this hashtag is an alias of the named hashtag.
replies_unmoderated optional boolean	In moderated groups, if this is `true` replies to these messages are not moderated.
special optional boolean	If `true`, messages with this tag will be sent as special notices.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a chat object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid name" is returned if the name is missing or invalid.
"bad_request"	"name exists" is returned if a hashtag with that name already exists.
"bad_request"	"invalid reply_to" is returned if the reply_to is missing or invalid.
"bad_request"	"invalid until" is returned if the until is missing or invalid.
"bad_request"	"invalid color" is returned if the color is missing or invalid.

POST /api/v1/updatehashtag
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatehashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "name=#Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("name", "#Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatehashtag",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'name': '#Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatehashtag', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 541,
   "object": "hashtag",
   "created": "2020-09-17T11:22:00-07:00",
   "group_id": 1188,
   "name": "Karl",
   "mods_only_post": false,
   "mods_only_replies": false,
   "no_email": false,
   "moderated": false,
   "special": true,
   "replies_unmoderated": false,
   "locked": true,
   "until": "hashtag_delete_month",
   "close_instead_of_delete": true,
   "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
   "color_name": "pink",
   "color_hex": "#f39de4",
   "reply_to": "thread_reply_to_sender",
   "topic_count": 1789,
   "last_message_date": "2020-09-08T01:22:00-07:00",
   "muted": null,
   "followed": null
}

View Hashtag definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Hashtags

Get hashtags

Permissions Needed

You must have the hashtags_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
usable_only optional boolean	If true, only return hashtags that the person has permission to use.
exclude_aliases optional boolean	If true, exclude hashtags that have been aliased to other hashtags.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a hashtag list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/gethashtags
cURL
Go
JavaScript

curl "https://groups.io/api/v1/gethashtags" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/gethashtags", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/gethashtags', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 13,
 "start_item": 6,
 "end_item": 56,
 "has_more": false,
 "next_page_token": 79,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   }
 ],
}

View Hashtag List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Hashtag

Delete a hashtag.

Permissions Needed

You must have the manage_hashtags permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
name required string	Name of the hashtag, should begin with #.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid name" is returned if the name is missing or invalid.

POST /api/v1/deletehashtag
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletehashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "name=#Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("name", "#Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletehashtag",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'name': '#Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletehashtag', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Mute Hashtag

Mute a hashtag.

Permissions Needed

You must be subscribed to the group.

POST Parameters

hashtag required string	Hashtag to mute.
group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
until required string	How long to mute the hashtag for, can be `mute_hour`, `mute_day`, `mute_week`, `mute_month`, `mute_forever`.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid until" is returned if the until value is invalid.

POST /api/v1/mutehashtag
cURL
Go
JavaScript

curl "https://groups.io/api/v1/mutehashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "hashtag=#test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("hashtag", "#test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/mutehashtag",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'hashtag': '#test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/mutehashtag', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Unmute Hashtag

Unmute a hashtag.

Permissions Needed

You must be subscribed to the group.

POST Parameters

hashtag required string	Hashtag to unmute.
group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"not muting hashtag" is returned if you are not currently muting this hashtag.

POST /api/v1/unmutehashtag
cURL
Go
JavaScript

curl "https://groups.io/api/v1/unmutehashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "hashtag=#test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("hashtag", "#test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/unmutehashtag",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'hashtag': '#test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/unmutehashtag', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Follow Hashtag

Follow a hashtag.

Permissions Needed

You must be subscribed to the group.

POST Parameters

hashtag required string	Hashtag to follow.
group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
until required string	How long to follow the hashtag for, can be `mute_hour`, `mute_day`, `mute_week`, `mute_month`, `mute_forever`.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid until" is returned if the until value is invalid.

POST /api/v1/followhashtag
cURL
Go
JavaScript

curl "https://groups.io/api/v1/followhashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "hashtag=#test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("hashtag", "#test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/followhashtag",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'hashtag': '#test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/followhashtag', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Unfollow Hashtag

Unfollow a hashtag.

Permissions Needed

You must be subscribed to the group.

POST Parameters

hashtag required string	Hashtag to unfollow.
group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"not following hashtag" is returned if you are not currently following this hashtag.

POST /api/v1/unfollowhashtag
cURL
Go
JavaScript

curl "https://groups.io/api/v1/unfollowhashtag" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "hashtag=#test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("hashtag", "#test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/unfollowhashtag",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'hashtag': '#test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/unfollowhashtag', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Login

Authenticate a user and return a login object, including HTTP cookies that are needed to access other API functions.

Query Parameters

email required string	The email address of the user.
password required string	The password of the user.
twofactor optional number	If the user account is configured to require two factor authentication, the second factor from an Authenticator app.
token optional boolean	If `true`, use token based login instead of cookie based login. With token based logins, some features of the API are not available, like chat.

Returns

Returns a login object if a valid email address/password pair is provided. In addition, one or more HTTP cookies are set in the response. Returns an error otherwise. If the account is configured to require two factor authentication, and the twofactor parameter is not provided, an two_factor_required is returned.

POST /api/v1/login
cURL
Go
JavaScript

curl "https://groups.io/api/v1/login" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "email=test@example.com" \
  -d "password=qwerty"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("email", "test@example.com")
    data.Set("password", "qwerty")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/login",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'email': 'test@example.com',
            'password': 'qwerty'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/login', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "user": 
   {
      "id": 147779411,
      "object": "user",
      "created": "2020-09-01T08:47:00-07:00",
      "updated": "2022-03-01T17:18:00-08:00",
      "email": "gersonbeahan@jacobi.io",
      "full_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "status": "user_status_confirmed",
      "profile_photo_url": "",
      "post_pref": "user_postpref_html",
      "per_page_pref": "user_per_page_pref20",
      "allow_facebook_login": false,
      "allow_google_login": false,
      "allow_sso_login": false,
      "csrf_token": "84491575",
      "two_factor_enabled": false,
      "recovery_codes": "",
      "dont_munge_message_id": false,
      "about_me": "Today awfully arrive at",
      "about_format": "about_html",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "time_pref": "standard_time",
      "date_pref": "us_date",
      "monday_start": false,
      "profile_privacy": "profile_private",
      "default_message_view": "thread_view",
      "topics_sort_dir": "sort_none",
      "topic_sort_dir": "sort_none",
      "messages_sort_dir": "sort_none",
      "expanded_messages_sort_dir": "sort_none",
      "search_sort": "relevance_sort",
      "search_sort_dir": "sort_none",
      "photos_order_by": "",
      "photos_sort_dir": "sort_none",
      "album_order_by": "",
      "album_sort_dir": "sort_none",
      "default_calendar_view": "cal_view_month",
      "default_hashtag_view": "view_grid",
      "default_rsvp_view": "view_grid",
      "home_page": "home_page_feed"
   },
 "token": "aabbffed2213234",
}

View Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Enterprise Info

Return information about an enterprise group.

Query Parameters

domain required string	Domain of the enterprise group.

Returns

Returns the enterprise info object. Returns an error if parameters are invalid (e.g. specifying an invalid domain). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid domain" is returned if the domain is missing or invalid.

GET /api/v1/enterpriseinfo
cURL
Go
JavaScript

curl "https://groups.io/api/v1/enterpriseinfo?domain=groups.example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/enterpriseinfo?domain=groups.example.com", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/enterpriseinfo');
    url.searchParams.append('domain', 'groups.example.com');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Logout

Clear all cookies associated with authentication.

Returns

Returns HTTP 200 on success.

GET /api/v1/logout
cURL
Go
JavaScript

curl "https://groups.io/api/v1/logout" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/logout", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/logout', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Send Login Link

Send a login link

Permissions Needed

None.

POST Parameters

email required string	The email address to send a login link.
redir optional string	URL to send the user to after they click on the login link.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid email). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid email" is returned if the email address is missing or invalid.
"bad_request"	"inactive user" is returned if the user account has been deactivated.

POST /api/v1/sendloginlink
cURL
Go
JavaScript

curl "https://groups.io/api/v1/sendloginlink" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "email=test@example.com"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("email", "test@example.com")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/sendloginlink",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'email': 'test@example.com'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/sendloginlink', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Authenticate Login Link

Authenticate a login link

Permissions Needed

None.

POST Parameters

cookie required number	The number from the login link.
twofactor optional number	If the user account is configured to require two factor authentication, the second factor from an Authenticator app.

Returns

Additional Errors

If the account is configured to require two factor authentication, and the twofactor parameter is not provided, an two_factor_required is returned.

POST /api/v1/authenticateloginlink
cURL
Go
JavaScript

curl "https://groups.io/api/v1/authenticateloginlink" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "cookie=12345678"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("cookie", "12345678")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/authenticateloginlink",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'cookie': '12345678'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/authenticateloginlink', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "user": 
   {
      "id": 147779411,
      "object": "user",
      "created": "2020-09-01T08:47:00-07:00",
      "updated": "2022-03-01T17:18:00-08:00",
      "email": "gersonbeahan@jacobi.io",
      "full_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "status": "user_status_confirmed",
      "profile_photo_url": "",
      "post_pref": "user_postpref_html",
      "per_page_pref": "user_per_page_pref20",
      "allow_facebook_login": false,
      "allow_google_login": false,
      "allow_sso_login": false,
      "csrf_token": "84491575",
      "two_factor_enabled": false,
      "recovery_codes": "",
      "dont_munge_message_id": false,
      "about_me": "Today awfully arrive at",
      "about_format": "about_html",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "time_pref": "standard_time",
      "date_pref": "us_date",
      "monday_start": false,
      "profile_privacy": "profile_private",
      "default_message_view": "thread_view",
      "topics_sort_dir": "sort_none",
      "topic_sort_dir": "sort_none",
      "messages_sort_dir": "sort_none",
      "expanded_messages_sort_dir": "sort_none",
      "search_sort": "relevance_sort",
      "search_sort_dir": "sort_none",
      "photos_order_by": "",
      "photos_sort_dir": "sort_none",
      "album_order_by": "",
      "album_sort_dir": "sort_none",
      "default_calendar_view": "cal_view_month",
      "default_hashtag_view": "view_grid",
      "default_rsvp_view": "view_grid",
      "home_page": "home_page_feed"
   },
 "token": "aabbffed2213234",
}

View Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Facebook Login Start

Start the Facebook login process.

Returns

Returns an oauth login object. Returns an error otherwise.

GET /api/v1/facebookloginstart
cURL
Go
JavaScript

curl "https://groups.io/api/v1/facebookloginstart" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/facebookloginstart", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/facebookloginstart', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "oauth_login",
 "state": "12345",
 "web_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "ios_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "android_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "scopes": ["user"],
}

View Oauth Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Facebook Login Final

Complete the Facebook login process. If the email address returned by Facebook matches an existing Groups.io user, then that user is logged in. If it does not match an existing user, a new user is created and logged in.

POST Parameters

state required string	Returned from earlier call to /facebookloginstart.
code required string	Returned from Facebook. Either code or access_token is required. If code is specified, we will exchange it for an access_token.
access_token required string	The access token from Facebook. Either code or access_token is required.

Returns

Returns a login object if a valid code and state are present. In addition, one or more HTTP cookies are set in the response. Returns an error otherwise.

Additional Errors

"bad_request"	"invalid state" is returned if the state parameter is invalid or missing.
"bad_request"	"invalid code or access_token" is returned if the code and access_token parameters are invalid or missing.
"bad_request"	"expired code" is returned if the code parameter is expired. Start the process over in this case.
"bad_request"	"inactive user" is returned if the user has been disabled.
"bad_request"	"invalid email address" is returned if the email address returned by Facebook is empty or invalid.
"bad_request"	"two factor enabled" is returned if the user has two-factor authentication enabled, which prevents Facebook logins.
"bad_request"	"facebook login prevented" is returned if the user has disabled Facebook logins. When this error is returned, an email is sent to the user with a link to enable Facebook logins.

POST /api/v1/facebookloginfinal
cURL
Go
JavaScript

curl "https://groups.io/api/v1/facebookloginfinal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "code=xxx" \
  -d "state=yyy"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("code", "xxx")
    data.Set("state", "yyy")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/facebookloginfinal",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'code': 'xxx',
            'state': 'yyy'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/facebookloginfinal', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "user": 
   {
      "id": 147779411,
      "object": "user",
      "created": "2020-09-01T08:47:00-07:00",
      "updated": "2022-03-01T17:18:00-08:00",
      "email": "gersonbeahan@jacobi.io",
      "full_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "status": "user_status_confirmed",
      "profile_photo_url": "",
      "post_pref": "user_postpref_html",
      "per_page_pref": "user_per_page_pref20",
      "allow_facebook_login": false,
      "allow_google_login": false,
      "allow_sso_login": false,
      "csrf_token": "84491575",
      "two_factor_enabled": false,
      "recovery_codes": "",
      "dont_munge_message_id": false,
      "about_me": "Today awfully arrive at",
      "about_format": "about_html",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "time_pref": "standard_time",
      "date_pref": "us_date",
      "monday_start": false,
      "profile_privacy": "profile_private",
      "default_message_view": "thread_view",
      "topics_sort_dir": "sort_none",
      "topic_sort_dir": "sort_none",
      "messages_sort_dir": "sort_none",
      "expanded_messages_sort_dir": "sort_none",
      "search_sort": "relevance_sort",
      "search_sort_dir": "sort_none",
      "photos_order_by": "",
      "photos_sort_dir": "sort_none",
      "album_order_by": "",
      "album_sort_dir": "sort_none",
      "default_calendar_view": "cal_view_month",
      "default_hashtag_view": "view_grid",
      "default_rsvp_view": "view_grid",
      "home_page": "home_page_feed"
   },
 "token": "aabbffed2213234",
}

View Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Apple Login Start

Start the Apple login process.

Returns

Returns an oauth login object. Returns an error otherwise.

GET /api/v1/appleloginstart
cURL
Go
JavaScript

curl "https://groups.io/api/v1/appleloginstart" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/appleloginstart", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/appleloginstart', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "oauth_login",
 "state": "12345",
 "web_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "ios_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "android_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "scopes": ["user"],
}

View Oauth Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Google Login Start

Start the Google login process.

Returns

Returns an oauth login object. Returns an error otherwise.

GET /api/v1/googleloginstart
cURL
Go
JavaScript

curl "https://groups.io/api/v1/googleloginstart" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/googleloginstart", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/googleloginstart', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "oauth_login",
 "state": "12345",
 "web_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "ios_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "android_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "scopes": ["user"],
}

View Oauth Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Apple Login Final

Complete the Apple login process. If the email address returned by Apple matches an existing Groups.io user, then that user is logged in. If it does not match an existing user, a new user is created and logged in. THIS IS CURRENTLY DISABLED.

POST Parameters

state required string	Returned from Apple.
code required string	Returned from Apple. Either code or access_token is required. If code is specified, we will exchange it for an access_token.
access_token required string	The access token from Apple. Either code or access_token is required.

Returns

Returns a login object if a valid code and state are present. In addition, one or more HTTP cookies are set in the response. Returns an error otherwise.

Additional Errors

"bad_request"	"invalid state" is returned if the state parameter is invalid or missing.
"bad_request"	"invalid code" is returned if the code parameter is invalid or missing.
"bad_request"	"inactive user" is returned if the user has been disabled.
"bad_request"	"two factor enabled" is returned if the user has two-factor authentication enabled, which prevents Apple logins.
"bad_request"	"invalid email address" is returned if the email address returned by Facebook is empty or invalid.
"bad_request"	"apple login prevented" is returned if the user has disabled Apple logins. When this error is returned, an email is sent to the user with a link to enable Apple logins.

POST /api/v1/appleloginfinal
cURL
Go
JavaScript

curl "https://groups.io/api/v1/appleloginfinal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "code=xxx" \
  -d "state=yyy"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("code", "xxx")
    data.Set("state", "yyy")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/appleloginfinal",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'code': 'xxx',
            'state': 'yyy'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/appleloginfinal', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "user": 
   {
      "id": 147779411,
      "object": "user",
      "created": "2020-09-01T08:47:00-07:00",
      "updated": "2022-03-01T17:18:00-08:00",
      "email": "gersonbeahan@jacobi.io",
      "full_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "status": "user_status_confirmed",
      "profile_photo_url": "",
      "post_pref": "user_postpref_html",
      "per_page_pref": "user_per_page_pref20",
      "allow_facebook_login": false,
      "allow_google_login": false,
      "allow_sso_login": false,
      "csrf_token": "84491575",
      "two_factor_enabled": false,
      "recovery_codes": "",
      "dont_munge_message_id": false,
      "about_me": "Today awfully arrive at",
      "about_format": "about_html",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "time_pref": "standard_time",
      "date_pref": "us_date",
      "monday_start": false,
      "profile_privacy": "profile_private",
      "default_message_view": "thread_view",
      "topics_sort_dir": "sort_none",
      "topic_sort_dir": "sort_none",
      "messages_sort_dir": "sort_none",
      "expanded_messages_sort_dir": "sort_none",
      "search_sort": "relevance_sort",
      "search_sort_dir": "sort_none",
      "photos_order_by": "",
      "photos_sort_dir": "sort_none",
      "album_order_by": "",
      "album_sort_dir": "sort_none",
      "default_calendar_view": "cal_view_month",
      "default_hashtag_view": "view_grid",
      "default_rsvp_view": "view_grid",
      "home_page": "home_page_feed"
   },
 "token": "aabbffed2213234",
}

View Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Google Login Final

Complete the Google login process. If the email address returned by Google matches an existing Groups.io user, then that user is logged in. If it does not match an existing user, a new user is created and logged in.

POST Parameters

state required string	Returned from Google.
code required string	Returned from Google. Either code or access_token is required. If code is specified, we will exchange it for an access_token.
access_token required string	The access token from Google. Either code or access_token is required.

Returns

Returns a login object if a valid code and state are present. In addition, one or more HTTP cookies are set in the response. Returns an error otherwise.

Additional Errors

"bad_request"	"invalid state" is returned if the state parameter is invalid or missing.
"bad_request"	"invalid code" is returned if the code parameter is invalid or missing.
"bad_request"	"inactive user" is returned if the user has been disabled.
"bad_request"	"two factor enabled" is returned if the user has two-factor authentication enabled, which prevents Google logins.
"bad_request"	"invalid email address" is returned if the email address returned by Facebook is empty or invalid.
"bad_request"	"google login prevented" is returned if the user has disabled Google logins. When this error is returned, an email is sent to the user with a link to enable Google logins.

POST /api/v1/googleloginfinal
cURL
Go
JavaScript

curl "https://groups.io/api/v1/googleloginfinal" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "code=xxx" \
  -d "state=yyy"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("code", "xxx")
    data.Set("state", "yyy")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/googleloginfinal",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'code': 'xxx',
            'state': 'yyy'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/googleloginfinal', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "user": 
   {
      "id": 147779411,
      "object": "user",
      "created": "2020-09-01T08:47:00-07:00",
      "updated": "2022-03-01T17:18:00-08:00",
      "email": "gersonbeahan@jacobi.io",
      "full_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "status": "user_status_confirmed",
      "profile_photo_url": "",
      "post_pref": "user_postpref_html",
      "per_page_pref": "user_per_page_pref20",
      "allow_facebook_login": false,
      "allow_google_login": false,
      "allow_sso_login": false,
      "csrf_token": "84491575",
      "two_factor_enabled": false,
      "recovery_codes": "",
      "dont_munge_message_id": false,
      "about_me": "Today awfully arrive at",
      "about_format": "about_html",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "time_pref": "standard_time",
      "date_pref": "us_date",
      "monday_start": false,
      "profile_privacy": "profile_private",
      "default_message_view": "thread_view",
      "topics_sort_dir": "sort_none",
      "topic_sort_dir": "sort_none",
      "messages_sort_dir": "sort_none",
      "expanded_messages_sort_dir": "sort_none",
      "search_sort": "relevance_sort",
      "search_sort_dir": "sort_none",
      "photos_order_by": "",
      "photos_sort_dir": "sort_none",
      "album_order_by": "",
      "album_sort_dir": "sort_none",
      "default_calendar_view": "cal_view_month",
      "default_hashtag_view": "view_grid",
      "default_rsvp_view": "view_grid",
      "home_page": "home_page_feed"
   },
 "token": "aabbffed2213234",
}

View Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Endpoints to manipulate member notices.

New Member Notice

Create a new member notice.

Permissions Needed

You must have the manage_group_settings permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
csrf required string	The `csrf_token` from the user object returned when first logged in.
name required string	Name of this member notice
type required string	Type of member notice, can be: `member_notice_joining`, `member_notice_pending`, `member_notice_leaving`, `member_notice_banned`, `member_notice_rejected_sub`, `member_notice_invite`, `member_notice_direct_add`, `member_notice_rejected_message`, `member_notice_removed_sub`, `member_notice_post_to_sub`, `member_notice_guidelines`, `member_notice_locked_group`, `member_notice_monthly_reminder`
subject required string	Subject used when sending emails
message required string	The message, in HTML format
guidelines_subject optional string	For Guidelines, the subject to use when sending the monthly email
is_default optional boolean	Use this message for email commands
send_on_join optional boolean	For Guidelines, send to new members at same time as welcome message
send_monthly optional boolean	For Guidelines, send monthly to the group members
send_monthly_special optional boolean	For Guidelines, send monthly to members on special only
private optional boolean	For Guidelines, if the guidelines are public or for members only
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member notice object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid name" is returned if the name is missing or invalid.
"bad_request"	"invalid subject" is returned if the subject is missing or invalid.
"bad_request"	"invalid type" is returned if the type is missing or invalid.
"bad_request"	"invalid message" is returned if the message is missing or invalid.
"bad_request"	"already have guidelines" is returned if the message is of type `group_message_guidelines` and there already is a notice of the same type.

POST /api/v1/newmembernotice
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newmembernotice" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "name=testing" \
  -d "subject=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("name", "testing")
    data.Set("subject", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newmembernotice",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'name': 'testing',
            'subject': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newmembernotice', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 43,
 "object": "member_notice",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 99,
 "type": "member_notice_banned",
 "name": "",
 "subject": "",
 "message": "",
 "is_default": false,
 "send_monthly": false,
 "send_monthly_special": false,
 "send_on_join": false,
 "private": false,
 "guidelines_monthly_subject": "",
}

View Member Notice definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Member Notice

Update a member notice object.

Permissions Needed

You must have the manage_group_settings permission to use this call with a group.

POST Parameters

member_notice_id required number	ID of the member notice to update.
csrf required string	The `csrf_token` from the user object returned when first logged in.
name optional string	Name of this member notice
type optional string	Type of member notice, can be: `member_notice_joining`, `member_notice_pending`, `member_notice_leaving`, `member_notice_banned`, `member_notice_rejected_sub`, `member_notice_invite`, `member_notice_direct_add`, `member_notice_rejected_message`, `member_notice_removed_sub`, `member_notice_post_to_sub`, `member_notice_guidelines`, `member_notice_locked_group`, `member_notice_monthly_reminder`
subject optional string	Subject used when sending emails
message optional string	The message, in HTML format
guidelines_subject optional string	For Guidelines, the subject to use when sending the monthly email
is_default optional boolean	Use this message for email commands
send_on_join optional boolean	For Guidelines, send to new members at same time as welcome message
send_monthly optional boolean	For Guidelines, send monthly to the group members
send_monthly_special optional boolean	For Guidelines, send monthly to members on special only
private optional boolean	For Guidelines, if the guidelines are public or for members only
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the member-notice object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid member_notice_id" is returned if the member_notice id is missing or invalid.
"bad_request"	"already have guidelines" is returned if the message is of type `group_message_guidelines` and there already is a notice of the same type.

POST /api/v1/updatemembernotice
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatemembernotice" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "member_notice_id=12" \
  -d "name=testing" \
  -d "subject=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("member_notice_id", "12")
    data.Set("name", "testing")
    data.Set("subject", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatemembernotice",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'member_notice_id': '12',
            'name': 'testing',
            'subject': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatemembernotice', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 16,
 "object": "member_notice",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 38,
 "type": "member_notice_banned",
 "name": "",
 "subject": "",
 "message": "",
 "is_default": false,
 "send_monthly": false,
 "send_monthly_special": false,
 "send_on_join": false,
 "private": false,
 "guidelines_monthly_subject": "",
}

View Member Notice definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Member Notice

Delete a member notice object.

Permissions Needed

You must have the manage_group_settings permission to use this call with a group.

POST Parameters

member_notice_id required number	ID of the member notice to delete.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid member_notice_id" is returned if the member notice id is missing or invalid.

POST /api/v1/deletemembernotice
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletemembernotice" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "member_notice_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("member_notice_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletemembernotice",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'member_notice_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletemembernotice', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Member Notices

Get member notices. Member notices are returned using the pagination request and object format.

Permissions Needed

You must have the manage_group_settings permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
type optional string	Type of member notice to return, can be: `member_notice_joining`, `member_notice_pending`, `member_notice_leaving`, `member_notice_banned`, `member_notice_rejected_sub`, `member_notice_invite`, `member_notice_direct_add`, `member_notice_rejected_message`, `member_notice_removed_sub`, `member_notice_post_to_sub`, `member_notice_guidelines`, `member_notice_locked_group`, `member_notice_monthly_reminder`
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are: `name`, `msgtype`, `updated`, `created`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member notice list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getmembernotices
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getmembernotices?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getmembernotices?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getmembernotices');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 18,
 "start_item": 46,
 "end_item": 62,
 "has_more": false,
 "next_page_token": 83,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 29,
    "object": "member_notice",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 93,
    "type": "member_notice_banned",
    "name": "",
    "subject": "",
    "message": "",
    "is_default": false,
    "send_monthly": false,
    "send_monthly_special": false,
    "send_on_join": false,
    "private": false,
    "guidelines_monthly_subject": "",
   }
 ],
}

View Member Notice List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Approve Pending Member

Approve a pending member.

Permissions Needed

You must have the manage_pending_members permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info object if the approval succeeded. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

Notes

The active Welcome member notice will be sent to the member, if there is one.
A subscription notification will be sent to all owners/moderators with that notification enabled.

POST /api/v1/approvemember
cURL
Go
JavaScript

curl "https://groups.io/api/v1/approvemember" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=1" \
  -d "member_info_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "1")
    data.Set("member_info_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/approvemember",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '1',
            'member_info_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/approvemember', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Ban Member

Ban this member.

Permissions Needed

You must have the ban_members permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info if the ban succeeded. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

bad_request	"user already banned" is returned if the member's `status` is already `sub_status_banned`
bad_request	"member cannot be a moderator or owner" is returned if the member's `mod_status` is not `sub_modstatus_none`

POST /api/v1/banmember
cURL
Go
JavaScript

curl "https://groups.io/api/v1/banmember" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=1" \
  -d "member_info_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "1")
    data.Set("member_info_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/banmember",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '1',
            'member_info_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/banmember', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Bulk Remove Members

Remove one or more members from a group.

Permissions Needed

You must have the remove_members permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
emails required string	A newline separated list of email addresses to remove.
csrf required string	The `csrf_token` from the user object returned when first logged in.
send_notice optional boolean	If true, send the Removed Member notice to each removed member.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a bulk remove results object if the bulk remove succeeded. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

Notes

If a removed member's status is sub_status_pending, the active Rejected Subscription member notice will be sent to the member, if there is one.
If a removed member's status is sub_status_normal, the active Removed Member notice will be sent to the member, if there is one.
If a removed member's status is sub_status_banned, no member notices will be sent out.

POST /api/v1/bulkremovemembers
cURL
Go
JavaScript

curl "https://groups.io/api/v1/bulkremovemembers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "TODO=FIX" \
  -d "group_id=1"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("TODO", "FIX")
    data.Set("group_id", "1")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/bulkremovemembers",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'TODO': 'FIX',
            'group_id': '1'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/bulkremovemembers', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Direct Add

Directly add people to a group.

Permissions Needed

You must have the invite_members permission to use this call. In addition, the group must be a Premium or Enterprise group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
emails required string	A newline separated list of email addresses to add.
csrf string	The `csrf_token` from the user object returned when first logged in.
subject optional string	Subject line to use for the direct add notification sent to users.
message optional string	Message to include with the direct add notification sent to users.
subgroupids optional string	A comma separated list of IDs of sub groups to also add these people to.
subgroupnames optional string	A comma separated list of names of sub groups to also add these people to.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a direct add results object if the approval succeeded. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

bad_request	"basic group" is returned if the group is not a premium or enterprise group.
bad_request	"trial group" is returned if the group is a trial group.
bad_request	"direct add in subgroup" is returned if the group_id refers to a subgroup and not a main group.
bad_request	"group is not a subgroup" is returned if a group ID in `subgroupids` refers to a group that is not a subgroup of the group.
pending_adds	Is returned if the adds require approval. The adds will take place once they have been reviewed.

Notes

For premium groups, there is a limit to the number of direct adds that can be done to a group per-day. Go over that limit and the pending_adds message will be returned. There is no daily limit for Enterprise groups.
If a subgroupid or subgroupname is specified that is actually a group alias, the pointed-to group will be used instead.

POST /api/v1/directadd
cURL
Go
JavaScript

curl "https://groups.io/api/v1/directadd" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=4"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "4")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/directadd",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '4'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/directadd', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "direct_add_results",
 "total_emails": 42,
 "errors": [
   {
    "object": "direct_add_error",
    "email": "",
    "alias_of": "",
    "status": "",
    "group_id": 61,
   }
 ],
 "added_members": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Direct Add Results definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Member

Get a member of a group. A member is represented by a member info object.

Permissions Needed

You must have the members_visible permission to use this call.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

No additional errors

GET /api/v1/getmember
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getmember?group_id=2&member_info_id=46" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getmember?member_info_id=46&group_id=2", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getmember');
    url.searchParams.append('group_id', '2');
    url.searchParams.append('member_info_id', '46');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Member Directory

Get the group member directory. Each member is represented by a member info object. Member info objects are returned using the pagination request and object format.

Permissions Needed

You must have the view_member_directory permission to use this call.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `full_name`.
sort_dir optional string	Sort direction. Can be 'asc' or 'desc'.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

"bad_request"	"private profile" is returned the user's profile is private. Only people without a private profile can view the member directory.

No additional errors

GET /api/v1/getmemberdirectory
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getmemberdirectory?group_id=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getmemberdirectory?group_id=7", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getmemberdirectory');
    url.searchParams.append('group_id', '7');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 35,
 "start_item": 8,
 "end_item": 41,
 "has_more": false,
 "next_page_token": 85,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Member Info List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Members

Get the members of a group. Each member is represented by a member info object. Member info objects are returned using the pagination request and object format.

Permissions Needed

You must have the members_visible or view_member_directory permission to use this call.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
type optional default is members	The type of member to be returned, can be `pending`, `banned`, `mods`, `members`, `bouncing`. See Notes for restrictions.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `full_name`, `email`, `delivery`, `joined`.
sort_dir optional string	Sort direction. Can be 'asc' or 'desc'.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

No additional errors

Notes

If you do not have the manage_pending_members permission, you cannot specify the type pending.
If you do not have the ban_members permission, you cannot specify the type banned.

GET /api/v1/getmembers
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getmembers?group_id=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getmembers?group_id=7", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getmembers');
    url.searchParams.append('group_id', '7');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 57,
 "start_item": 25,
 "end_item": 58,
 "has_more": false,
 "next_page_token": 63,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Member Info List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Past Members

Get the past members of a group. Each member is represented by a past member object. Objects are returned using the pagination request and object format.

Permissions Needed

You must have the members_visible permission to use this call. In addition, the group must be a Premium or Enterprise group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `full_name`, `email`, `reason`, `created`.
sort_dir optional string	Sort direction. Can be 'asc' or 'desc'.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a past member list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

No additional errors

GET /api/v1/getpastmembers
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getpastmembers?group_id=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getpastmembers?group_id=7", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getpastmembers');
    url.searchParams.append('group_id', '7');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 33,
 "start_item": 36,
 "end_item": 93,
 "has_more": false,
 "next_page_token": 32,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 89,
    "object": "past_member",
    "created": "2009-11-10T15:00:00-08:00",
    "action": "spamleft",
    "member_info": 
      {
         "id": 93846546,
         "object": "member_info",
         "created": "2020-09-09T04:11:00-07:00",
         "updated": "2022-06-08T07:16:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "group_name": "StrategyHub",
         "status": "sub_status_normal",
         "post_status": "sub_poststatus_newusermoderated",
         "email_delivery": "email_delivery_digest",
         "message_selection": "message_selection_follow_and_first_message",
         "auto_follow_replies": false,
         "max_attachment_size": "max_attachment_size_medium",
         "approved_posts": 0,
         "mod_status": "sub_modstatus_owner",
         "pending_msg_notify": "sub_notify_email_and_app",
         "pending_sub_notify": "sub_notify_email_and_app",
         "sub_notify": "sub_notify_email_and_app",
         "storage_notify": "sub_notify_email_and_app",
         "sub_group_notify": "sub_notify_email_and_app",
         "message_report_notify": "sub_notify_email_and_app",
         "account_notify": "sub_notify_email_and_app",
         "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
         "owner_msg_notify": "sub_ownermsg_notify_subs",
         "chat_notify": "sub_notify_email_and_app",
         "photo_notify": "sub_notify_email_and_app",
         "file_notify": "sub_notify_email_and_app",
         "wiki_notify": "sub_notify_email_and_app",
         "database_notify": "sub_notify_email_and_app",
         "email": "gersonbeahan@jacobi.io",
         "user_status": "user_status_confirmed",
         "user_name": "Dickens6041",
         "timezone": "America/Chicago",
         "full_name": "Lawson Kreiger",
         "about_me": "Today awfully arrive at",
         "location": "Well away onto",
         "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "profile_privacy": "profile_private",
         "dont_munge_message_id": false,
         "use_signature": false,
         "use_signature_email": false,
         "signature": "In hotel furniture anyone weakly besides",
         "color": "color_cerulean_blue",
         "cover_photo_url": "",
         "icon_url": "",
         "nice_group_name": "",
         "subs_count": 0,
         "most_recent_message": "0001-01-01T00:00:00Z",
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "member_labels": [
           {
             "id": 726,
             "object": "memberlabel",
             "created": "2020-09-29T22:19:00Z",
             "group_id": 1857,
             "name": "Florida",
             "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
             "color_name": "green-sage",
             "color_hex": "#9fc4ac"
           },
           {
             "id": 1594,
             "object": "memberlabel",
             "created": "2020-09-24T02:24:00Z",
             "group_id": 42,
             "name": "Russel",
             "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
             "color_name": "purple",
             "color_hex": "#837fd5"
           },
           {
             "id": 1189,
             "object": "memberlabel",
             "created": "2020-09-12T02:11:00Z",
             "group_id": 1474,
             "name": "Meta",
             "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
             "color_name": "sky",
             "color_hex": "#9cc7df"
           }
         ],
         "extra_member_data": [
           {
             "col_id": 48876437,
             "col_type": "text_column",
             "text": "To firstly unlock while host himself me purely as whose."
           },
           {
             "col_id": 161476183,
             "col_type": "paragraph_column",
             "text": "Yet few mustering example will addition yearly since in these."
           },
           {
             "col_id": 39354277,
             "col_type": "checkbox_column",
             "checked": false
           },
           {
             "col_id": 8897324,
             "col_type": "multiple_choice_column",
             "multi_choice": [
               0
             ]
           },
           {
             "col_id": 159828550,
             "col_type": "date_column",
             "date": "1916-10-16T17:57:55.797000001Z"
           },
           {
             "col_id": 185149472,
             "col_type": "time_column",
             "time": "1919-03-30T18:00:36.790929649Z"
           },
           {
             "col_id": 166814414,
             "col_type": "address_column",
             "street_address1": "Premier Medical Group",
             "street_address2": "3701 DAUPHIN ST",
             "city": "MOBILE",
             "state": "AL",
             "zip": "36608-1756",
             "lat": 30.6866076,
             "lng": -88.13019249999999
           },
           {
             "col_id": 102385421,
             "col_type": "multi_choice_column",
             "multi_choice": [
               0,
               1,
               2
             ]
           },
           {
             "col_id": 154317202,
             "col_type": "link_column",
             "title": "To say poorly out according abundant unless nervously string lastly.",
             "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
             "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
           },
           {
             "col_id": 123191768,
             "col_type": "image_column",
             "url": "https://picsum.photos/id/27/187/110",
             "image_name": "Lately blazer with wild hourly there she it infrequently power."
           },
           {
             "col_id": 53386358,
             "col_type": "html_paragraph_column",
             "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
           },
           {
             "col_id": 45812071,
             "col_type": "email_column",
             "text": "brantkozey@bernhard.com"
           }
         ]
      },
   }
 ],
}

View Past Member List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Remove Member

Remove a member from a group.

Permissions Needed

You must have the remove_members permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

No additional errors

Notes

If the member's status is sub_status_pending, the active Rejected Subscription member notice will be sent to the member, if there is one.
If the member's status is sub_status_normal, the active Removed Member notice will be sent to the member, if there is one.
If the member's status is sub_status_banned, no member notices will be sent out.

POST /api/v1/removemember
cURL
Go
JavaScript

curl "https://groups.io/api/v1/removemember" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=1" \
  -d "member_info_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "1")
    data.Set("member_info_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/removemember",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '1',
            'member_info_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/removemember', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Search Member Directory

Search the member directory. The search is over full names and profile information. Each member is represented by a member info object. Member info objects are returned using the pagination request and object format.

Permissions Needed

You must have the view_member_directory permission to use this call.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
q required string	Email or name fragment to search on.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `full_name`, `email`, `delivery`, `joined`.
sort_dir optional string	Sort direction. Can be 'asc' or 'desc'.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

No additional errors

GET /api/v1/searchmemberdirectory
cURL
Go
JavaScript

curl "https://groups.io/api/v1/searchmemberdirectory?group_id=7&q=Fred" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/searchmemberdirectory?q=Fred&group_id=7", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/searchmemberdirectory');
    url.searchParams.append('group_id', '7');
    url.searchParams.append('q', 'Fred');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 67,
 "start_item": 50,
 "end_item": 44,
 "has_more": false,
 "next_page_token": 69,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Member Info List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Search Members

Search the members of a group. The search is over email addresses, full names and moderator notes. Each member is represented by a member info object. Member info objects are returned using the pagination request and object format.

Permissions Needed

You must have the members_visible permission to use this call.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
q required string	Email or name fragment to search on.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `full_name`, `email`, `delivery`, `joined`.
sort_dir optional string	Sort direction. Can be 'asc' or 'desc'.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

No additional errors

GET /api/v1/searchmembers
cURL
Go
JavaScript

curl "https://groups.io/api/v1/searchmembers?group_id=7&q=smith.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/searchmembers?group_id=7&q=smith.com", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/searchmembers');
    url.searchParams.append('group_id', '7');
    url.searchParams.append('q', 'smith.com');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 17,
 "start_item": 34,
 "end_item": 1,
 "has_more": false,
 "next_page_token": 34,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Member Info List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Send A Bounce Probe

Send a bounce probe.

Permissions Needed

You must have the manage_member_subscription_options permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

bad_request	"user not bouncing" is returned if the member's `user_status` is not either `user_status_bouncing` and `user_status_bounced`

POST /api/v1/sendbounceprobe
cURL
Go
JavaScript

curl "https://groups.io/api/v1/sendbounceprobe" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=1" \
  -d "member_info_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "1")
    data.Set("member_info_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/sendbounceprobe",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '1',
            'member_info_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/sendbounceprobe', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Send A Confirmation Email

Send a confirmation email.

Permissions Needed

You must have the manage_member_subscription_options permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

bad_request	"user not unconfirmed" is returned if the member's `user_status` is not `user_status_not_confirmed`

POST /api/v1/sendconfirmation
cURL
Go
JavaScript

curl "https://groups.io/api/v1/sendconfirmation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=1" \
  -d "member_info_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "1")
    data.Set("member_info_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/sendconfirmation",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '1',
            'member_info_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/sendconfirmation', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Send Invites

Send invites.

Permissions Needed

You must have the send_invites permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
emails required string	A newline separated list of email addresses to invite.
csrf string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

NOTE: This call is not yet finished and documented.

Additional Errors

No additional errors

POST /api/v1/invite
cURL
Go
JavaScript

curl "https://groups.io/api/v1/invite" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=4"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "4")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/invite",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '4'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/invite', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "direct_add_results",
 "total_emails": 32,
 "errors": [
   {
    "object": "direct_add_error",
    "email": "",
    "alias_of": "",
    "status": "",
    "group_id": 37,
   }
 ],
 "added_members": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Direct Add Results definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Unban Member

Unban this member.

Permissions Needed

You must have the ban_members permission to use this call.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 if the unban succeeded. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

bad_request	"user not banned" is returned if the member's `status` is not `sub_status_banned`
bad_request	"member cannot be a moderator or owner" is returned if the member's `mod_status` is not `sub_modstatus_none`

POST /api/v1/unbanmember
cURL
Go
JavaScript

curl "https://groups.io/api/v1/unbanmember" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=1" \
  -d "member_info_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "1")
    data.Set("member_info_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/unbanmember",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '1',
            'member_info_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/unbanmember', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Member

Change a member's subscription.

Permissions Needed

You must have the manage_member_subscription_options permission to use this call, in addition to any permissions specified below.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.
post_status optional string	Posting status, can be `sub_poststatus_normal`, `sub_poststatus_allowed`, `sub_poststatus_moderated`, `sub_poststatus_notallowed`, `sub_poststatus_newusermoderated`, `sub_poststatus_mod_first_message`, `sub_poststatus_mod_started_topics`
email_delivery optional string	Email delivery, can be `email_delivery_single`, `email_delivery_digest`, `email_delivery_special`, `email_delivery_none`, `email_delivery_html_digest`, `email_delivery_summary`
message_selection optional string	Message selection, can be `message_selection_all`, `message_selection_follow_only`, `message_selection_follow_and_first_message`
auto_follow_replies optional boolean	Automatically follow any topics you start or reply to.
max_attachment_size optional string	Maximum attachment size, can be `max_attachment_size_unlimited`, `max_attachment_size_small`, `max_attachment_size_medium`, `max_attachment_size_large`, `max_attachment_size_none`
full_name optional string	The member's full name.
moderator_notes optional string	Notes about the member.
chat_msg_notify optional string	Notify when someone posts a message to a chat this person is subscribed to, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
like_notify optional string	Notify when someone likes a message this person posted, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
You must have the `make_moderator` permission in order to set these fields
mod_status optional string	Moderator status, can be `sub_modstatus_none`, `sub_modstatus_moderator`, `sub_modstatus_owner`
mod_permissions optional string	Moderator permissions, comma separated list of zero or more of the following: `sub_perm_pendingmsgs`, `sub_perm_pendingmembers`, `sub_perm_invitemembers`, `sub_perm_removemembers`, `sub_perm_banmembers`, `sub_perm_makemoderator`, `sub_perm_managehashtags`, `sub_perm_groupsettings`, `sub_perm_modsub`, `sub_perm_integrations`, `sub_perm_editarchives`, `sub_perm_billing`, `sub_perm_managesubgroups`
pending_msg_notify optional string	Notify about pending messages, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
pending_sub_notify optional string	Notify about pending subscriptions, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
sub_notify optional string	Notify when someone joins the group, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
storage_notify optional string	Notify when storage limits are reached, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
sub_group_notify optional string	Notify when a subgroup is created, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
message_report_notify optional string	Notify when someone reports a message, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
chat_notify optional string	Notify when someone starts a chat, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
photo_notify optional string	Notify when someone creates a photo album or uploads a photo, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
file_notify optional string	Notify when someone creates a folder or uploads a file, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
wiki_notify optional string	Notify when someone creates or modifies a wiki page, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
database_notify optional string	Notify when someone creates or modifies a database, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
color optional string	Color assigned to the member.
member_labels optional string (multiple)	Array of member label IDs to assign to the member. Can also include new label temporary IDs (prefixed with 'new_') to create and assign new labels.
new_label_names optional string (multiple)	Array of names for new labels being created (corresponds to memberlabels with 'new' prefix).
new_label_colors optional string (multiple)	Array of color values for new labels being created (corresponds to memberlabels with 'new' prefix).
new_label_descriptions optional string (multiple)	Array of descriptions for new labels being created (corresponds to memberlabels with 'new' prefix).
owner_msg_notify optional string	Receive messages sent to the +owner address, can be `sub_ownermsg_notify_all`, `sub_ownermsg_notify_subs`, `sub_ownermsg_notify_none`
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.
	The following fields relate to setting extra_member_data fields. Each column, as defined in the `extra_member_data_columns` array in the Group Object, consists of a Database Column Object, which defines the various aspects of the column.
text_N optional string	Response for `text` and `paragraph` columns. N is the ID of column.
number_N optional number	Response for `number` columns. N is the ID of column.
editor_N optional string	Response for `html_paragraph` columns. N is the ID of column.
checked_N optional boolean	Response for `checkbox` columns. N is the ID of column.
choice_N optional boolean	Response for `multiple_choice` columns. N is the ID of column.
multichoice_N_M optional boolean	Response for `multi_choice` columns. N is the ID of column. M corresponds to the `choices` array in the database column object, indexed starting at 1.
date_N optional string	Response for `date` columns. N is the ID of the column.
time_N optional string	Response for `time` columns. N is the ID of the column.
address1_N optional string	First address line for `address` columns. N is the ID of the column.
address2_N optional string	Second address line for `address` columns. N is the ID of the column.
city_N optional string	City line for `address` columns. N is the ID of the column.
state_N optional string	State line for `address` columns. N is the ID of the column.
zip_N optional string	Zip line for `address` columns. N is the ID of the column.
country_N optional string	Country line for `address` columns. N is the ID of the column.
url_N optional string	URL for `link` columns. N is the ID of the column.
title_N optional string	Title for `link` columns. N is the ID of the column.
desc_N optional string	Description for `link` columns. N is the ID of the column.

Returns

Returns a member info object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

"bad_request"	"sole group owner" is returned if changing the `mod_status` field will leave the group without any owners.
"bad_request"	"moderators cannot change role of owners" is returned if a non-owner attempts to change the `mod_status` field of an owner.
"bad_request"	"moderators cannot make members owners" is returned if a non-owner attempts to make a member an owner.
"bad_request"	"moderators cannot change owner subscription settings" is returned if a non-owner attempts to change an owner's subscription settings.

Notes

If email_delivery is switched from either email_delivery_digest or email_delivery_html_digest to one of the non-digest options, and there are pending digest messages, a digest will be generated at this time.

POST /api/v1/updatemember
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatemember" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=1" \
  -d "member_info_id=2" \
  -d "post_status=sub_poststatus_normal"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "1")
    data.Set("member_info_id", "2")
    data.Set("post_status", "sub_poststatus_normal")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatemember",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '1',
            'member_info_id': '2',
            'post_status': 'sub_poststatus_normal'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatemember', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

These API endpoints deal with pushsub notifications.

Add Push Sub

Permissions Needed

None.

POST Parameters

token required string	Device ID token.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid token" is returned if the token is missing or invalid.

POST /api/v1/addpushsub
cURL
Go
JavaScript

curl "https://groups.io/api/v1/addpushsub" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "token=abcdef"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("token", "abcdef")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/addpushsub",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'token': 'abcdef'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/addpushsub', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Test Notification

Send a test notification.

Permissions Needed

None.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.
token required string	Device ID token.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid token" is returned if the token is missing or invalid.

POST /api/v1/testnotification
cURL
Go
JavaScript

curl "https://groups.io/api/v1/testnotification" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/testnotification",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/testnotification', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Push Subs

Get push subs. Push subs are returned using the pagination request and object format.

Permissions Needed

None.

Query Parameters

limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.

Returns

Returns a push sub list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getpushsubs
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getpushsubs" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getpushsubs", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getpushsubs', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 49,
 "start_item": 27,
 "end_item": 41,
 "has_more": false,
 "next_page_token": 76,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 21,
    "object": "push_sub",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 27,
    "type": "mobile_push_sub",
    "os": "",
    "browser": "app",
    "p256dh": "",
    "auth": "",
    "endpoint": "",
   }
 ],
}

View Push Sub List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Push Subscription

Delete a single push subscription.

Permissions Needed

None.

POST Parameters

pushsub_id required number	ID of the pushsub to delete. You must be the owner of the pushsub.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid pushsub_id" is returned if the pushsub id is missing or invalid.

POST /api/v1/deletepushsub
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletepushsub" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "pushsub_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("pushsub_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletepushsub",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'pushsub_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletepushsub', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete All Push Subscriptions

Delete all push subscriptions for a user.

Permissions Needed

None.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

None.

POST /api/v1/deleteallpushsubs
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deleteallpushsubs" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deleteallpushsubs",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deleteallpushsubs', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Orgs represent enterprise groups.

Get Org

Get the org object associated with the domain the API request came in on.

Permissions Needed

You must be an owner of the requested enterprise group.

Query Parameters

None

Returns

Returns an org object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getorg
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getorg" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getorg", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getorg', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 1,
   "object": "org",
   "created": "1969-12-31T16:00:00-08:00",
   "updated": "1969-12-31T16:00:00-08:00",
   "title": "Groups.io",
   "domain": "groups.io",
   "parent_group_id": 0,
   "logged_out_wiki_page_id": 0,
   "default_timezone": "",
   "disable_signup": false,
   "disable_plus_one": false,
   "ga_code": "",
   "login_page_text": "",
   "no_account_text": "",
   "sso_provider": "no_sso",
   "sso_client_id": "",
   "sso_client_secret": "",
   "sso_domain": ""
}

View Org definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Pending Messages

Get pending messages. Pending messages are returned using the pagination request and object format.

Permissions Needed

You must have the manage_pending_messages permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.

Returns

Returns a pending message list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getpendingmessages
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getpendingmessages?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getpendingmessages?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getpendingmessages');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 71,
 "start_item": 48,
 "end_item": 29,
 "has_more": false,
 "next_page_token": 26,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "object": "pending_message",
    "id": 69,
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 36,
    "user_id": 84,
    "subject": "",
    "is_special": false,
    "is_web_post": false,
    "has_attachments": false,
    "editor_member_id": 92,
    "raw_message": "",
    "message_body": "",
    "body_format": "",
    "sender": 
      {
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "name": "Lawson Kreiger",
         "can_view_profile": false
      },
    "sender_email": "",
    "sender_name": "",
    "claiming_user": 
      {
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "name": "Lawson Kreiger",
         "can_view_profile": false
      },
    "claimed_date": "2009-11-10T15:00:00-08:00",
    "editor": 
      {
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "name": "Lawson Kreiger",
         "can_view_profile": false
      },
    "edit_reason": "",
    "type": "",
    "virus_name": "",
   }
 ],
}

View Pending Message List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Approve Pending Messages

Approve pending message objects. Messages are sent to the group and the pending message objects are deleted.

Permissions Needed

You must have the manage_pending_messages permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
pending_message_ids required numbers	Comma separated list of IDs of the pending messages to approve.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid pending_message_ids" is returned if the pending message id is missing or invalid.
"bad_request"	"message claimed" is returned if the pending message has previously been claimed by someone else.

POST /api/v1/approvependingmessages
cURL
Go
JavaScript

curl "https://groups.io/api/v1/approvependingmessages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "pending_message_ids=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("pending_message_ids", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/approvependingmessages",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'pending_message_ids': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/approvependingmessages', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Claim Pending Message

Claim a pending message object. The pending message will be claimed by the currently logged in user.

Permissions Needed

You must have the manage_pending_messages permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
pending_message_id required number	ID of the pending message to delete.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid pending_message_id" is returned if the pending message id is missing or invalid.

POST /api/v1/claimpendingmessage
cURL
Go
JavaScript

curl "https://groups.io/api/v1/claimpendingmessage" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "pending_message_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("pending_message_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/claimpendingmessage",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'pending_message_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/claimpendingmessage', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Pending Messages

Delete pending message objects.

Permissions Needed

You must have the manage_pending_messages permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
pending_message_ids required numbers	Comma separated list of IDs of the pending messages to delete. All messages must be in the same group.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid pending_message_ids" is returned if the pending message id is missing or invalid.
"bad_request"	"message claimed" is returned if the pending message has previously been claimed by someone else.

POST /api/v1/deletependingmessages
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletependingmessages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "pending_message_ids=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("pending_message_ids", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletependingmessages",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'pending_message_ids': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletependingmessages', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Reject Pending Messages

Reject pending message objects. A rejection message is sent to the sender of each message and the pending message is deleted.

Permissions Needed

You must have the manage_pending_messages permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
pending_message_ids required numbers	Comma separated list of IDs of the pending messages to reject.
reason required string	The message to send the person who sent each pending message, in plain text.
subject required string	The subject line of the message to send the person who sent the pending message, in plain text.
bccall optional boolean	If `true`, email all group moderators a copy of the rejection message.
bccme optional boolean	If `true`, email me a copy of the rejection message.
csrf required string	The `csrf_token` from the user object returned when first logged in.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid pending_message_ids" is returned if the pending message id is missing or invalid.
"bad_request"	"invalid reason" is returned if the reason is missing or invalid.
"bad_request"	"invalid subject" is returned if the subject is missing or invalid.
"bad_request"	"message claimed" is returned if the pending message has previously been claimed by someone else.

POST /api/v1/rejectpendingmessages
cURL
Go
JavaScript

curl "https://groups.io/api/v1/rejectpendingmessages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "pending_message_ids=12" \
  -d "reason="I'm rejecting this"" \
  -d "subject="Rejection message""

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("pending_message_ids", "12")
    data.Set("reason", ""I'm rejecting this"")
    data.Set("subject", ""Rejection message"")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/rejectpendingmessages",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'pending_message_ids': '12',
            'reason': '"I'm rejecting this"',
            'subject': '"Rejection message"'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/rejectpendingmessages', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

These are the API endpoints for albums and photos.

New Photo Album

Create a new photo album. The album is created.

Permissions Needed

You must have the manage_photos permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
title required string	The title of the album.
desc required string	The description of the album, in plain text format.
upload_perms required string	Who can upload photos to this album. Can be: `album_upload_group` or `album_upload_personal`.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a album object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid title" is returned if the title is missing or invalid.
"bad_request"	"invalid desc" is returned if the desc is missing or invalid.
"bad_request"	"invalid upload_perms" is returned if the upload_perms parameter is missing or invalid.

POST /api/v1/newalbum
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newalbum" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "desc=testing" \
  -d "group_id=12" \
  -d "title=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("desc", "testing")
    data.Set("group_id", "12")
    data.Set("title", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newalbum",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'desc': 'testing',
            'group_id': '12',
            'title': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newalbum', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 52691321,
   "object": "album",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "upload_perms": "album_upload_group",
   "title": "Including tribe anything from whose market",
   "desc": "Pyramid accordingly onto moreover whenever e.g. fear usually body kilometer. Nightly child so firstly he next each secondly must catch. Politely sleepy where i.e. inquisitively yours wisp regularly nice cackle. Ourselves heavily now this our yearly what few why where. Win most would everybody them backwards this that provided store.",
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@...",
   "total_photos": 24
}

View Album definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Photo Album

Update a photo album.

Permissions Needed

You must be the owner of the album.

POST Parameters

album_id required number	ID of the album.
title optional string	The title of the album.
desc optional string	The description of the album, in plain text format.
upload_perms optional string	Who can upload photos to this album. Can be: `album_upload_group` or `album_upload_personal`.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a album object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid album_id" is returned if the album_id is missing or invalid.
"bad_request"	"invalid title" is returned if the title is invalid.
"bad_request"	"invalid desc" is returned if the desc is invalid.
"bad_request"	"invalid upload_perms" is returned if the upload_perms parameter is invalid.

POST /api/v1/updatealbum
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatealbum" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "album_id=32" \
  -d "desc=testing" \
  -d "title=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("album_id", "32")
    data.Set("desc", "testing")
    data.Set("title", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatealbum",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'album_id': '32',
            'desc': 'testing',
            'title': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatealbum', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 52691321,
   "object": "album",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "upload_perms": "album_upload_group",
   "title": "Including tribe anything from whose market",
   "desc": "Pyramid accordingly onto moreover whenever e.g. fear usually body kilometer. Nightly child so firstly he next each secondly must catch. Politely sleepy where i.e. inquisitively yours wisp regularly nice cackle. Ourselves heavily now this our yearly what few why where. Win most would everybody them backwards this that provided store.",
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@...",
   "total_photos": 24
}

View Album definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Photo Albums

Get photo albums. ALbums are returned using the pagination request and object format.

Permissions Needed

You must have the photos_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are: `title`, `created`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an album list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

Notes

Depending on settings, the first album returned may be the Emailed Photos album, which is an album of photos that were sent through messages. This album will have an ID of 0.

GET /api/v1/getalbums
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getalbums?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getalbums?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getalbums');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "album",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "upload_perms": "album_upload_group",
       "title": "Including tribe anything from whose",
       "desc": "Market pyramid accordingly onto moreover whenever e.g. fear usually body. Kilometer nightly child so firstly he next each secondly must. Catch politely sleepy where i.e. inquisitively yours wisp regularly nice. Cackle ourselves heavily now this our yearly what few why. Where win most would everybody them backwards this that provided.",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "total_photos": 18
     },
     {
       "id": 134723079,
       "object": "album",
       "created": "2020-10-01T09:06:00-07:00",
       "updated": "2022-06-06T16:00:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "upload_perms": "album_upload_group",
       "title": "Whom I company Roman indeed",
       "desc": "Words trade move outside downstairs of exemplified up out destroy. Due taste anything where this that would whom to cautiously. Till only himself fight our whomever that for her our. Much nevertheless which numerous alone bevy as by from e.g.. Otherwise laptop cloud then them yourselves few look fleet say.",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "total_photos": 27
     },
     {
       "id": 112832928,
       "object": "album",
       "created": "2020-09-14T20:59:00-07:00",
       "updated": "2022-11-29T01:40:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "upload_perms": "album_upload_group",
       "title": "Cruelly rarely over",
       "desc": "By otherwise its to a e.g. congregation cackle themselves previously. In for theirs they my there road disappear accordingly hotel. So today by over have this Romanian abroad around while. Belong ever into each whatever fortnightly he agreeable sari anyone. Therefore does could exaltation of sit everyone they had mustering.",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "total_photos": 13
     }
   ]
}

View Album List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Photo Album

Delete a photo album. Any photos within the album that you have permission to delete will be removed. If the photo album is then empty, it is deleted. In order to delete a photo, you must either be the owner of the photo or a moderator/owner of the group.

Permissions Needed

You must be the owner of the album.

POST Parameters

album_id required number	ID of the album.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid album_id" is returned if the album_id is missing or invalid.

POST /api/v1/deletealbum
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletealbum" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "album_id=32"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("album_id", "32")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletealbum",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'album_id': '32'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletealbum', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Add Photos

Add photos.

Permissions Needed

You must have permission to add photos to the album.

Query Parameters

album_id required number	ID of the photo album to add the photo to.
fileupload required multipart file	Multipart file upload of one or more photos.
description optional string	A description to be added to the photos.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a photo list object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid album_id" is returned if the album id is missing or invalid.
"bad_request"	"no space" is returned if the group is out of storage space.
"bad_request"	"too big" is returned if the photo is too large.

POST /api/v1/addphotos
cURL
Go
JavaScript

curl "https://groups.io/api/v1/addphotos" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/addphotos",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/addphotos', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 1253,
       "object": "photo",
       "created": "2020-08-30T23:30:00-07:00",
       "updated": "2023-04-23T17:44:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Store elegance joy group Senegalese",
       "desc": "Whichever happen trade move outside downstairs of exemplified up out. Destroy due taste anything where this that would whom to. Cautiously till only himself fight our whomever that for her. Our much nevertheless which numerous alone bevy as by from. E.g. otherwise laptop cloud then them yourselves few look fleet.",
       "media_type": "image/jpg",
       "size": 9234415,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 52691321,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 777,
       "object": "photo",
       "created": "2020-09-23T03:05:00-07:00",
       "updated": "2022-11-16T21:00:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "As yesterday we inquire",
       "desc": "Ourselves his laugh string several accordingly kindness bit stand woman. Just poised they enough thing homework each clothing other cry. Obediently refill do differs yearly those woman pen today as. Now ourselves first for without what might any where as. Out me were Norwegian significant his do mob notice lastly.",
       "media_type": "image/jpg",
       "size": 5695695,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 127437101,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 1620,
       "object": "photo",
       "created": "2020-09-26T00:12:00-07:00",
       "updated": "2023-03-26T20:23:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Then result these preen numerous on",
       "desc": "Frequently him at tonight is seriously why kiss logic beyond. Him swing our Amazonian will for myself everybody I abundant. Few weekly anyone an weekly someone being that her enthusiasm. Yours never without theirs mine that delay that the air. Whatever bundle you is such batch accommodation without now in.",
       "media_type": "image/jpg",
       "size": 8923756,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 7850581,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     }
   ]
}

View Photo List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Photo

Update a photo.

Permissions Needed

You must be the owner of the photo.

POST Parameters

photo_id required number	ID of the photo.
name optional string	The name of the photo
desc optional string	The description of the photo, in plain text format.
cover_photo optional bool	If true, make this photo the cover photo for the album.
rotate optional number	Degrees to rotate the photo, in increments of 90 degrees. Can be: 90, 180, 270, -90, -180, -270.
album_id optional number	If provided, this moves the photo to the album. You must have permission to add photos to that album and the album must be in the same group.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a photo object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid photo_id" is returned if the photo_id is missing or invalid.
"bad_request"	"invalid name" is returned if the name is invalid.
"bad_request"	"invalid desc" is returned if the desc is invalid.
"bad_request"	"invalid rotate" is returned if the rotate parameter is invalid.
"bad_request"	"invalid album_id" is returned if the album_id parameter is invalid.
"bad_request"	"no space" is returned if the group is out of space.

POST /api/v1/updatephoto
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatephoto" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "desc=testing" \
  -d "name=Test" \
  -d "photo_id=32"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("desc", "testing")
    data.Set("name", "Test")
    data.Set("photo_id", "32")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatephoto",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'desc': 'testing',
            'name': 'Test',
            'photo_id': '32'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatephoto', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 52691321,
   "object": "album",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "upload_perms": "album_upload_group",
   "title": "Including tribe anything from whose market",
   "desc": "Pyramid accordingly onto moreover whenever e.g. fear usually body kilometer. Nightly child so firstly he next each secondly must catch. Politely sleepy where i.e. inquisitively yours wisp regularly nice cackle. Ourselves heavily now this our yearly what few why where. Win most would everybody them backwards this that provided store.",
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@...",
   "total_photos": 24
}

View Album definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Photo

Get photo.

Permissions Needed

You must have the photos_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
album_id required number	ID of the album that contains the photo, or 0 if viewing a photo sent as a message attachment.
photo_id required number	ID of the photo to fetch.
attachment_num required number	If viewing a photo sent as a message attachment, this is the `attachment_num` from that photo. If `album_id` is 0, this field must be specified.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an photo object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid album_id" is returned if the album id is invalid or you do not have permission to view it.
"bad_request"	"invalid photo_id" is returned if the photo id is missing or invalid or you do not have permission to view it.

GET /api/v1/getphoto
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getphoto?photo_id=12&attachment_num=2&group_id=12&album_id=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getphoto?attachment_num=2&group_id=12&album_id=0&photo_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getphoto');
    url.searchParams.append('album_id', '0');
    url.searchParams.append('attachment_num', '2');
    url.searchParams.append('group_id', '12');
    url.searchParams.append('photo_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 960,
   "object": "photo",
   "created": "2020-09-06T23:48:00-07:00",
   "updated": "2022-03-08T08:06:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "name": "Elegance joy group",
   "desc": "Senegalese whichever happen trade move outside downstairs of exemplified up. Out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for. Her our much nevertheless which numerous alone bevy as by. From e.g. otherwise laptop cloud then them yourselves few look.",
   "media_type": "image/jpg",
   "size": 2390440,
   "attachment_num": 0,
   "width": 0,
   "height": 0,
   "album_id": 52691321,
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@...",
   "format": "jpeg",
   "focal_length": 0,
   "iso": 0,
   "aperture": 0,
   "shutter_speed": 0,
   "taken": 0,
   "make": "",
   "model": ""
}

View Photo definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Photos

Get photos. Photos are returned using the pagination request and object format.

Permissions Needed

You must have the photos_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
album_id required number	ID of the photo album to view.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are: `created`, `name`, `taken`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an photo list object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid album_id" is returned if the album id is missing or invalid.

Notes

To view the Emailed Photos album, pass in an album_id of 0.

GET /api/v1/getphotos
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getphotos?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getphotos?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getphotos');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 1253,
       "object": "photo",
       "created": "2020-08-30T23:30:00-07:00",
       "updated": "2023-04-23T17:44:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Store elegance joy group Senegalese",
       "desc": "Whichever happen trade move outside downstairs of exemplified up out. Destroy due taste anything where this that would whom to. Cautiously till only himself fight our whomever that for her. Our much nevertheless which numerous alone bevy as by from. E.g. otherwise laptop cloud then them yourselves few look fleet.",
       "media_type": "image/jpg",
       "size": 9234415,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 52691321,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 777,
       "object": "photo",
       "created": "2020-09-23T03:05:00-07:00",
       "updated": "2022-11-16T21:00:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "As yesterday we inquire",
       "desc": "Ourselves his laugh string several accordingly kindness bit stand woman. Just poised they enough thing homework each clothing other cry. Obediently refill do differs yearly those woman pen today as. Now ourselves first for without what might any where as. Out me were Norwegian significant his do mob notice lastly.",
       "media_type": "image/jpg",
       "size": 5695695,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 127437101,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 1620,
       "object": "photo",
       "created": "2020-09-26T00:12:00-07:00",
       "updated": "2023-03-26T20:23:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Then result these preen numerous on",
       "desc": "Frequently him at tonight is seriously why kiss logic beyond. Him swing our Amazonian will for myself everybody I abundant. Few weekly anyone an weekly someone being that her enthusiasm. Yours never without theirs mine that delay that the air. Whatever bundle you is such batch accommodation without now in.",
       "media_type": "image/jpg",
       "size": 8923756,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 7850581,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     }
   ]
}

View Photo List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Search Photos

Search photos. Photos are returned using the pagination request and object format.

Permissions Needed

You must have the photos_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
q required string	Query string.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are: `created`, `name`, `taken`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an photo list object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid query" is returned if the query string is empty.

GET /api/v1/searchphotos
cURL
Go
JavaScript

curl "https://groups.io/api/v1/searchphotos?group_id=12&q=Test" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/searchphotos?group_id=12&q=Test", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/searchphotos');
    url.searchParams.append('group_id', '12');
    url.searchParams.append('q', 'Test');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 1253,
       "object": "photo",
       "created": "2020-08-30T23:30:00-07:00",
       "updated": "2023-04-23T17:44:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Store elegance joy group Senegalese",
       "desc": "Whichever happen trade move outside downstairs of exemplified up out. Destroy due taste anything where this that would whom to. Cautiously till only himself fight our whomever that for her. Our much nevertheless which numerous alone bevy as by from. E.g. otherwise laptop cloud then them yourselves few look fleet.",
       "media_type": "image/jpg",
       "size": 9234415,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 52691321,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 777,
       "object": "photo",
       "created": "2020-09-23T03:05:00-07:00",
       "updated": "2022-11-16T21:00:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "As yesterday we inquire",
       "desc": "Ourselves his laugh string several accordingly kindness bit stand woman. Just poised they enough thing homework each clothing other cry. Obediently refill do differs yearly those woman pen today as. Now ourselves first for without what might any where as. Out me were Norwegian significant his do mob notice lastly.",
       "media_type": "image/jpg",
       "size": 5695695,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 127437101,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 1620,
       "object": "photo",
       "created": "2020-09-26T00:12:00-07:00",
       "updated": "2023-03-26T20:23:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Then result these preen numerous on",
       "desc": "Frequently him at tonight is seriously why kiss logic beyond. Him swing our Amazonian will for myself everybody I abundant. Few weekly anyone an weekly someone being that her enthusiasm. Yours never without theirs mine that delay that the air. Whatever bundle you is such batch accommodation without now in.",
       "media_type": "image/jpg",
       "size": 8923756,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 7850581,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     }
   ]
}

View Photo List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Photo

Delete a photo.

Permissions Needed

You must either be the owner of the photo or a moderator/owner of the group.

POST Parameters

photo_id required number	ID of the photo.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid photo_id" is returned if the photo_id is missing or invalid.

POST /api/v1/deletephoto
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletephoto" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "photo_id=32"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("photo_id", "32")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletephoto",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'photo_id': '32'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletephoto', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

New Poll

Create a new poll. The poll is created.

Permissions Needed

You must have the manage_polls permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
question required string	The subject of the poll.
desc required string	The description of the poll, in HTML format.
announce required boolean	If `true`, send an announcement of the poll to the group.
answer required multiple, string	Possible answers to the poll. At least two must be specified.
multiple optional boolean	If `true`, allow multiple responses.
results_at_end optional boolean	If `true`, only allow results to be shown after the poll is closed.
no_results optional boolean	If `true`, do not show results.
anonymous optional boolean	If `true`, do not show who voted.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a poll object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Success Responses

"pending post"	Returned if the poll requires approval before it is sent to the group.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid question" is returned if the question is missing or invalid.
"bad_request"	"invalid desc" is returned if the desc is missing or invalid.
"bad_request"	"not enough answers" is returned if there are not enough questions specified.
"bad_request"	"need hashtag" is returned if a hashtag is required in the question.
"bad_request"	"restricted hashtag" is returned if a restricted hashtag is used in the question.
"bad_request"	"mod only hashtag" is returned if a moderator only hashtag is used in the question.
"bad_request"	"post too big" is returned if the resulting post is too large for the group.
"bad_request"	"announce group" is returned if this poll was sent to an announcement group by a non-moderator.

POST /api/v1/newpoll
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newpoll" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "answer=answer+2" \
  -d "desc=testing" \
  -d "group_id=12" \
  -d "question=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("answer", "answer+2")
    data.Set("desc", "testing")
    data.Set("group_id", "12")
    data.Set("question", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newpoll",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'answer': 'answer+2',
            'desc': 'testing',
            'group_id': '12',
            'question': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newpoll', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 42,
 "object": "poll",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 4,
 "group_id": 85,
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "question": "",
 "desc": "",
 "multiple": false,
 "results_at_end": false,
 "never_show_results": false,
 "can_view_results": false,
 "answers": [
   {
    "answer": "",
    "selected": false,
   }
 ],
 "results": [
   {
    "answer": "",
    "count": 66,
    "percentage": "",
    "votes": [
      {
       "user_id": 70,
       "email": "",
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
      }
    ],
   }
 ],
 "is_closed": false,
 "msg_num": 46,
 "anonymous": false,
}

View Poll definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Poll

Update an existing poll.

Permissions Needed

You must have the manage_polls permission to use this call with a group. In addition, you either must be the author of the poll or a moderator of the group.

POST Parameters

poll_id required number	ID of the poll to update.
question required string	The subject of the poll.
desc required string	The description of the poll, in HTML format.
announce required boolean	If `true`, send an announcement of the poll to the group.
answer required multiple, string	Possible answers to the poll. At least two must be specified.
edit_msg optional string	Reason for changing the poll.
multiple optional boolean	If `true`, allow multiple responses.
results_at_end optional boolean	If `true`, only allow results to be shown after the poll is closed.
no_results optional boolean	If `true`, do not show results.
anonymous optional boolean	If `true`, do not show who voted.
close optional boolean	If `true`, close the poll.
reopen optional boolean	If `true`, reopen the poll.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a poll object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid poll_id" is returned if the poll id is missing or invalid.
"bad_request"	"invalid question" is returned if the question is missing or invalid.
"bad_request"	"invalid desc" is returned if the desc is missing or invalid.
"bad_request"	"not enough answers" is returned if there are not enough questions specified.
"bad_request"	"need hashtag" is returned if a hashtag is required in the question.
"bad_request"	"restricted hashtag" is returned if a restricted hashtag is used in the question.
"bad_request"	"mod only hashtag" is returned if a moderator only hashtag is used in the question.
"bad_request"	"post too big" is returned if the resulting post is too large for the group.
"bad_request"	"announce group" is returned if this poll was sent to an announcement group by a non-moderator.

POST /api/v1/updatepoll
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatepoll" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "desc=testing" \
  -d "poll_id=12" \
  -d "subject=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("desc", "testing")
    data.Set("poll_id", "12")
    data.Set("subject", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatepoll",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'desc': 'testing',
            'poll_id': '12',
            'subject': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatepoll', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 16,
 "object": "poll",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 33,
 "group_id": 76,
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "question": "",
 "desc": "",
 "multiple": false,
 "results_at_end": false,
 "never_show_results": false,
 "can_view_results": false,
 "answers": [
   {
    "answer": "",
    "selected": false,
   }
 ],
 "results": [
   {
    "answer": "",
    "count": 82,
    "percentage": "",
    "votes": [
      {
       "user_id": 28,
       "email": "",
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
      }
    ],
   }
 ],
 "is_closed": false,
 "msg_num": 53,
 "anonymous": false,
}

View Poll definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Poll

Get a poll.

Permissions Needed

You must have the archives_visible permission to use this call with a group.

POST Parameters

poll_id required number	ID of the poll to update.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a poll object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid poll_id" is returned if the poll id is missing or invalid.

POST /api/v1/getpoll
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getpoll" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "poll_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("poll_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/getpoll",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'poll_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getpoll', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "id": 14,
 "object": "poll",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 57,
 "group_id": 6,
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "question": "",
 "desc": "",
 "multiple": false,
 "results_at_end": false,
 "never_show_results": false,
 "can_view_results": false,
 "answers": [
   {
    "answer": "",
    "selected": false,
   }
 ],
 "results": [
   {
    "answer": "",
    "count": 70,
    "percentage": "",
    "votes": [
      {
       "user_id": 34,
       "email": "",
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
      }
    ],
   }
 ],
 "is_closed": false,
 "msg_num": 45,
 "anonymous": false,
}

View Poll definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Poll Results

Get poll results.

Permissions Needed

You must have the archives_visible permission to use this call with a group.

POST Parameters

poll_id required number	ID of the poll.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a poll results object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid poll_id" is returned if the poll id is missing or invalid.
"bad_request"	"can't view poll results" is returned if the user cannot view the poll results.

POST /api/v1/getpollresults
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getpollresults" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "poll_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("poll_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/getpollresults",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'poll_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getpollresults', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "poll_id": 91,
 "object": "poll_results",
 "results": [
   {
    "answer": "",
    "count": 67,
    "percentage": "",
    "votes": [
      {
       "user_id": 53,
       "email": "",
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
      }
    ],
   }
 ],
}

View Poll Results definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Vote

Vote in a poll.

Permissions Needed

You must have the can_vote permission to use this call with a group.

POST Parameters

poll_id required number	ID of the poll to update.
csrf required string	The `csrf_token` from the user object returned when first logged in.
answer required number	ID of the answer. Depending on the poll, you may be able to specify multiple answers.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a poll object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid poll_id" is returned if the poll id is missing or invalid.
"bad_request"	"no answers" is returned if no answers are specified.
"bad_request"	"poll closed" is returned if the poll has been closed.

POST /api/v1/vote
cURL
Go
JavaScript

curl "https://groups.io/api/v1/vote" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "answer=2" \
  -d "poll_id=12"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("answer", "2")
    data.Set("poll_id", "12")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/vote",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'answer': '2',
            'poll_id': '12'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/vote', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

These is the API endpoint for reporting content.

Report Content

Report content.

Permissions Needed

You must have permission to add files to the folder.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
report_to required string	Where to send the report. Can be: `mods`, `support`.
reason required string	Reason for the complaint.
csrf required string	The `csrf_token` from the user object returned when first logged in.
message_id string	ID of the `message` object to report. One of `message_id`, `file_id`, or `photo_id` must be included in the request.
file_id string	ID of the `file` object to report. One of `message_id`, `file_id`, or `photo_id` must be included in the request.
photo_id string	ID of the `photo` object to report. One of `message_id`, `file_id`, or `photo_id` must be included in the request.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"missing reason" is returned if the reason field is missing or empty.
"bad_request"	"invalid report_to" is returned if the report_to field is invalid.
"bad_request"	"missing either message_id, photo_id, or file_id" is returned if an appropriate ID is not included.

POST /api/v1/reportcontent
cURL
Go
JavaScript

curl "https://groups.io/api/v1/reportcontent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "message_id=321" \
  -d "reason=Inappropriate" \
  -d "report_to=mods"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("message_id", "321")
    data.Set("reason", "Inappropriate")
    data.Set("report_to", "mods")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/reportcontent",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'message_id': '321',
            'reason': 'Inappropriate',
            'report_to': 'mods'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/reportcontent', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Sub Group Categories

Get sub group categories. Categories are returned using the pagination request and object format.

Permissions Needed

You must have the subgroups_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are "name" and "order".
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a Sub Group Catgeory list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getsubgroupcategories
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getsubgroupcategories?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getsubgroupcategories?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getsubgroupcategories');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 43,
 "start_item": 16,
 "end_item": 24,
 "has_more": false,
 "next_page_token": 41,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 61,
    "object": "sub_group_category",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "parent_group_id": 97,
    "name": "example",
    "desc": "",
    "max_subs": 15,
    "order": 2,
   }
 ],
}

View Sub Group Category List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Sub Groups By Category

Get sub groups by category.

Permissions Needed

You must have the subgroups_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the parent group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the parent group. Either `group_id` or `group_name` must be specified.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a Sub Groups By Catgeory object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getsubgroupsbycategory
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getsubgroupsbycategory?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getsubgroupsbycategory?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getsubgroupsbycategory');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "subscribed": [
   {
    "category": 
      {
       "id": 98,
       "object": "sub_group_category",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "parent_group_id": 61,
       "name": "example",
       "desc": "",
       "max_subs": 62,
       "order": 10,
      },
    "group": 
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      },
   }
 ],
 "uncategorized": [
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   }
 ],
 "by_category": [
   {
    "category": 
      {
       "id": 62,
       "object": "sub_group_category",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "parent_group_id": 22,
       "name": "example",
       "desc": "",
       "max_subs": 80,
       "order": 25,
      },
    "group": 
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      },
   }
 ],
}

View Sub Groups By Category definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Register User

POST Parameters

email required string	Email address of the new user.
password required string	Password for the new user.

Returns

Returns a login object if a valid email address/password pair is provided. In addition, one or more HTTP cookies are set in the response. Returns an error otherwise.

Additional Errors

bad_request	"invalid email" is returned if the email address is invalid.
bad_request	"email exists" is returned if the email address already exists.
bad_request	"password too short" is returned if the password is too short.

Notes

A confirmation email will be sent to the new user.

POST /api/v1/registeruser
cURL
Go
JavaScript

curl "https://groups.io/api/v1/registeruser" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "email=test@example.com" \
  -d "password=passw0rd"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("email", "test@example.com")
    data.Set("password", "passw0rd")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/registeruser",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'email': 'test@example.com',
            'password': 'passw0rd'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/registeruser', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "user": 
   {
      "id": 147779411,
      "object": "user",
      "created": "2020-09-01T08:47:00-07:00",
      "updated": "2022-03-01T17:18:00-08:00",
      "email": "gersonbeahan@jacobi.io",
      "full_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "status": "user_status_confirmed",
      "profile_photo_url": "",
      "post_pref": "user_postpref_html",
      "per_page_pref": "user_per_page_pref20",
      "allow_facebook_login": false,
      "allow_google_login": false,
      "allow_sso_login": false,
      "csrf_token": "84491575",
      "two_factor_enabled": false,
      "recovery_codes": "",
      "dont_munge_message_id": false,
      "about_me": "Today awfully arrive at",
      "about_format": "about_html",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "time_pref": "standard_time",
      "date_pref": "us_date",
      "monday_start": false,
      "profile_privacy": "profile_private",
      "default_message_view": "thread_view",
      "topics_sort_dir": "sort_none",
      "topic_sort_dir": "sort_none",
      "messages_sort_dir": "sort_none",
      "expanded_messages_sort_dir": "sort_none",
      "search_sort": "relevance_sort",
      "search_sort_dir": "sort_none",
      "photos_order_by": "",
      "photos_sort_dir": "sort_none",
      "album_order_by": "",
      "album_sort_dir": "sort_none",
      "default_calendar_view": "cal_view_month",
      "default_hashtag_view": "view_grid",
      "default_rsvp_view": "view_grid",
      "home_page": "home_page_feed"
   },
 "token": "aabbffed2213234",
}

View Login definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get User

Return the user information associated with the logged in user.

GET /api/v1/getuser
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getuser" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getuser", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/getuser', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 147779411,
   "object": "user",
   "created": "2020-09-01T08:47:00-07:00",
   "updated": "2022-03-01T17:18:00-08:00",
   "email": "gersonbeahan@jacobi.io",
   "full_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "status": "user_status_confirmed",
   "profile_photo_url": "",
   "post_pref": "user_postpref_html",
   "per_page_pref": "user_per_page_pref20",
   "allow_facebook_login": false,
   "allow_google_login": false,
   "allow_sso_login": false,
   "csrf_token": "84491575",
   "two_factor_enabled": false,
   "recovery_codes": "",
   "dont_munge_message_id": false,
   "about_me": "Today awfully arrive at",
   "about_format": "about_html",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "time_pref": "standard_time",
   "date_pref": "us_date",
   "monday_start": false,
   "profile_privacy": "profile_private",
   "default_message_view": "thread_view",
   "topics_sort_dir": "sort_none",
   "topic_sort_dir": "sort_none",
   "messages_sort_dir": "sort_none",
   "expanded_messages_sort_dir": "sort_none",
   "search_sort": "relevance_sort",
   "search_sort_dir": "sort_none",
   "photos_order_by": "",
   "photos_sort_dir": "sort_none",
   "album_order_by": "",
   "album_sort_dir": "sort_none",
   "default_calendar_view": "cal_view_month",
   "default_hashtag_view": "view_grid",
   "default_rsvp_view": "view_grid",
   "home_page": "home_page_feed"
}

View User definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update User

Updates the authenticated user by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.
email optional string	New email address. The user object will be set to `user_status_not_confirmed` and a confirmation email will be sent out.
password optional string	New password.
timezone optional string	New timezone.
post_pref optional string	Posting preference, `user_postpref_html`, `user_postpref_plain`, `user_postpref_markdown`
per_page_pref optional string	Per page display preference, `user_per_page_pref20`, `user_per_page_pref50`, `user_per_page_pref100`, `user_per_page_pref_infinite`
time_pref optional string	How to display times, `standard_time`, `military_time`
date_pref optional string	How to display dates, `us_date`, `iso_date`, `international_date`
language_pref optional string	Language preference, `no_language_pref`, `language_english`, `language_french`, `language_german`, `language_spanish`, `language_ukrainian`, `language_italian`
dont_munge_message_id optional boolean	Whether to change the message-id of any posted messages. In the user interface, this is the "I always want copies of my own emails" checkbox.
allow_facebook_login optional boolean	Allow login to your account via Facebook.
allow_google_login optional boolean	Allow login to your account via Google.
allow_sso_login optional boolean	Allow login to your account via Single Sign On.
monday_start optional boolean	If the calendar should start on Monday (defaults to Sunday).
default_hashtag_view optional string	Set the default hashtag view. Can be: `hashtag_view_grid` or `hashtag_view_list`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the user object if the update succeeded. Returns an error if update parameters are invalid (e.g. specifying an invalid email address). Below are the unique errors to this call.

Additional Errors

bad_request	"same email" is returned if the new email address is the same as the old email address.
bad_request	"invalid email" is returned if the new email address is invalid.
bad_request	"email exists" is returned if the new email address already exists.
bad_request	"password too short" is returend if the password is too short.
bad_request	"invalid default_hashtag_view" is returned if the provided default_hashtag_view is incorrect.

Notes

If the email address of the user has changed, a new authentication cookie will be set.

POST /api/v1/updateuser
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updateuser" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "email=test@example.com"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("email", "test@example.com")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updateuser",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'email': 'test@example.com'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updateuser', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 147779411,
   "object": "user",
   "created": "2020-09-01T08:47:00-07:00",
   "updated": "2022-03-01T17:18:00-08:00",
   "email": "gersonbeahan@jacobi.io",
   "full_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "status": "user_status_confirmed",
   "profile_photo_url": "",
   "post_pref": "user_postpref_html",
   "per_page_pref": "user_per_page_pref20",
   "allow_facebook_login": false,
   "allow_google_login": false,
   "allow_sso_login": false,
   "csrf_token": "84491575",
   "two_factor_enabled": false,
   "recovery_codes": "",
   "dont_munge_message_id": false,
   "about_me": "Today awfully arrive at",
   "about_format": "about_html",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "time_pref": "standard_time",
   "date_pref": "us_date",
   "monday_start": false,
   "profile_privacy": "profile_private",
   "default_message_view": "thread_view",
   "topics_sort_dir": "sort_none",
   "topic_sort_dir": "sort_none",
   "messages_sort_dir": "sort_none",
   "expanded_messages_sort_dir": "sort_none",
   "search_sort": "relevance_sort",
   "search_sort_dir": "sort_none",
   "photos_order_by": "",
   "photos_sort_dir": "sort_none",
   "album_order_by": "",
   "album_sort_dir": "sort_none",
   "default_calendar_view": "cal_view_month",
   "default_hashtag_view": "view_grid",
   "default_rsvp_view": "view_grid",
   "home_page": "home_page_feed"
}

View User definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Profile

Updates the authenticated user's profile.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.
member_info_id optional number	To change the profile information for just one subscription, supply the member_info_id of that subscription.
full_name optional string	Your name.
user_name optional string	Your user name. Only applicable when `member_info_id` is not specified.
about_me optional string	Your about me section, in HTML format.
location optional string	Your location.
website optional string	Your website.
profile_privacy optional string	Your profile privacy setting. Can be: `profile_private`, `profile_members`, `profile_public`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the user object if the update succeeded. Returns an error if update parameters are invalid (e.g. specifying an invalid member_info_id). Below are the unique errors to this call.

Additional Errors

bad_request	"invalid member_info_id" is returned if the provided member_info_id is incorrect.
bad_request	"invalid profile_privacy" is returned if the provided profile_privacy is incorrect.

POST /api/v1/updateprofile
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updateprofile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "full_name=Joe+Smith"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("full_name", "Joe+Smith")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updateprofile",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'full_name': 'Joe+Smith'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updateprofile', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 147779411,
   "object": "user",
   "created": "2020-09-01T08:47:00-07:00",
   "updated": "2022-03-01T17:18:00-08:00",
   "email": "gersonbeahan@jacobi.io",
   "full_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "status": "user_status_confirmed",
   "profile_photo_url": "",
   "post_pref": "user_postpref_html",
   "per_page_pref": "user_per_page_pref20",
   "allow_facebook_login": false,
   "allow_google_login": false,
   "allow_sso_login": false,
   "csrf_token": "84491575",
   "two_factor_enabled": false,
   "recovery_codes": "",
   "dont_munge_message_id": false,
   "about_me": "Today awfully arrive at",
   "about_format": "about_html",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "time_pref": "standard_time",
   "date_pref": "us_date",
   "monday_start": false,
   "profile_privacy": "profile_private",
   "default_message_view": "thread_view",
   "topics_sort_dir": "sort_none",
   "topic_sort_dir": "sort_none",
   "messages_sort_dir": "sort_none",
   "expanded_messages_sort_dir": "sort_none",
   "search_sort": "relevance_sort",
   "search_sort_dir": "sort_none",
   "photos_order_by": "",
   "photos_sort_dir": "sort_none",
   "album_order_by": "",
   "album_sort_dir": "sort_none",
   "default_calendar_view": "cal_view_month",
   "default_hashtag_view": "view_grid",
   "default_rsvp_view": "view_grid",
   "home_page": "home_page_feed"
}

View User definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Profile Photo

Updates the authenticated user's profile photo.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.
imageupload required multipart file	Multipart file upload of a new profile photo. The photo can be in GIF or JPEG format.
member_info_id optional number	To change the profile photo for just one subscription, supply the member_info_id of that subscription.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the user object if the update succeeded. Returns an error if update parameters are invalid (e.g. specifying an invalid member_info_id). Below are the unique errors to this call.

Additional Errors

bad_request	"invalid member_info_id" is returned if the provided member_info_id is incorrect.

POST /api/v1/updateprofilephoto
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updateprofilephoto" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updateprofilephoto",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updateprofilephoto', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 147779411,
   "object": "user",
   "created": "2020-09-01T08:47:00-07:00",
   "updated": "2022-03-01T17:18:00-08:00",
   "email": "gersonbeahan@jacobi.io",
   "full_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "status": "user_status_confirmed",
   "profile_photo_url": "",
   "post_pref": "user_postpref_html",
   "per_page_pref": "user_per_page_pref20",
   "allow_facebook_login": false,
   "allow_google_login": false,
   "allow_sso_login": false,
   "csrf_token": "84491575",
   "two_factor_enabled": false,
   "recovery_codes": "",
   "dont_munge_message_id": false,
   "about_me": "Today awfully arrive at",
   "about_format": "about_html",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "time_pref": "standard_time",
   "date_pref": "us_date",
   "monday_start": false,
   "profile_privacy": "profile_private",
   "default_message_view": "thread_view",
   "topics_sort_dir": "sort_none",
   "topic_sort_dir": "sort_none",
   "messages_sort_dir": "sort_none",
   "expanded_messages_sort_dir": "sort_none",
   "search_sort": "relevance_sort",
   "search_sort_dir": "sort_none",
   "photos_order_by": "",
   "photos_sort_dir": "sort_none",
   "album_order_by": "",
   "album_sort_dir": "sort_none",
   "default_calendar_view": "cal_view_month",
   "default_hashtag_view": "view_grid",
   "default_rsvp_view": "view_grid",
   "home_page": "home_page_feed"
}

View User definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Profile Photo

Deletes the authenticated user's profile photo.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.
member_info_id optional number	To delete the profile photo for just one subscription, supply the member_info_id of that subscription.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns the user object if the update succeeded. Returns an error if update parameters are invalid (e.g. specifying an invalid member_info_id). Below are the unique errors to this call.

Additional Errors

bad_request	"invalid member_info_id" is returned if the provided member_info_id is incorrect.

POST /api/v1/deleteprofilephoto
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deleteprofilephoto" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d ""csrf=12345""

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set(""csrf", "12345"")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deleteprofilephoto",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            '"csrf': '12345"'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deleteprofilephoto', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 147779411,
   "object": "user",
   "created": "2020-09-01T08:47:00-07:00",
   "updated": "2022-03-01T17:18:00-08:00",
   "email": "gersonbeahan@jacobi.io",
   "full_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "status": "user_status_confirmed",
   "profile_photo_url": "",
   "post_pref": "user_postpref_html",
   "per_page_pref": "user_per_page_pref20",
   "allow_facebook_login": false,
   "allow_google_login": false,
   "allow_sso_login": false,
   "csrf_token": "84491575",
   "two_factor_enabled": false,
   "recovery_codes": "",
   "dont_munge_message_id": false,
   "about_me": "Today awfully arrive at",
   "about_format": "about_html",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "time_pref": "standard_time",
   "date_pref": "us_date",
   "monday_start": false,
   "profile_privacy": "profile_private",
   "default_message_view": "thread_view",
   "topics_sort_dir": "sort_none",
   "topic_sort_dir": "sort_none",
   "messages_sort_dir": "sort_none",
   "expanded_messages_sort_dir": "sort_none",
   "search_sort": "relevance_sort",
   "search_sort_dir": "sort_none",
   "photos_order_by": "",
   "photos_sort_dir": "sort_none",
   "album_order_by": "",
   "album_sort_dir": "sort_none",
   "default_calendar_view": "cal_view_month",
   "default_hashtag_view": "view_grid",
   "default_rsvp_view": "view_grid",
   "home_page": "home_page_feed"
}

View User definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Subscription

Get a subscription to a single group.

Query Parameters

group_id required number	ID of the group.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info object if the update succeeded. Returns an error if update parameters are invalid (e.g. specifying an invalid parameter). Below are the unique errors to this call.

GET /api/v1/getsub
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getsub?group_id=2" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getsub?group_id=2", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getsub');
    url.searchParams.append('group_id', '2');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Subscriptions

Get the subscriptions associated with the logged in user. Subscriptions are returned using the pagination request and object format.

Query Parameters

set_home_page optional boolean	If `true`, set the user's default home page to the Groups page.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional opaque	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Can be `group`, `approvals`, `size`, `activity`, `delivery`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info list object if successful. Returns an error if parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

GET /api/v1/getsubs
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getsubs?limit=2&page_token=1" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getsubs?limit=2&page_token=1", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getsubs');
    url.searchParams.append('limit', '2');
    url.searchParams.append('page_token', '1');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 47,
 "start_item": 43,
 "end_item": 24,
 "has_more": false,
 "next_page_token": 8,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

View Member Info List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Resend Confirmation Email

Resend a confirmation email to a user with status user_status_not_confirmed.

Permissions Needed

None.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid email). Below are the unique errors to this call.

Additional Errors

"bad_request"	"user is not not confirmed" is returned if the user is not in the `user_status_not_confirmed` state.

POST /api/v1/resendconfirmationemail
cURL
Go
JavaScript

curl "https://groups.io/api/v1/resendconfirmationemail" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d ""csrf=12345""

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set(""csrf", "12345"")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/resendconfirmationemail",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            '"csrf': '12345"'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/resendconfirmationemail', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Unbounce User

Unbounce a user.

Permissions Needed

None.

POST Parameters

csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid email). Below are the unique errors to this call.

Additional Errors

"bad_request"	"user is not bouncing" is returned if the user is not in the `user_status_bouncing` or `user_status_bounced` state.

POST /api/v1/unbounceuser
cURL
Go
JavaScript

curl "https://groups.io/api/v1/unbounceuser" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/unbounceuser",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/unbounceuser', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Subscription

Updates a subscription by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

POST Parameters

member_info_id required number	ID of the member info object.
csrf required string	The `csrf_token` from the user object returned when first logged in.
email_delivery optional string	Email delivery, can be `email_delivery_single`, `email_delivery_digest`, `email_delivery_special`, `email_delivery_none`, `email_delivery_html_digest`, `email_delivery_summary`
message_selection optional string	Message selection, can be `message_selection_all`, `message_selection_follow_only`, `message_selection_follow_and_first_message`
auto_follow_replies optional boolean
max_attachment_size optional string	Maximum attachment size, can be `max_attachment_size_unlimited`, `max_attachment_size_small`, `max_attachment_size_medium`, `max_attachment_size_large`, `max_attachment_size_none`
signature optional string	Signature to be used for signing messages.
sig_format optional string	Format of the signature, can be `sig_format_html`, `sig_format_markdown`, `sig_format_plain`. Ignored if `signature` is also not specified.
use_signature optional boolean	Whether to use the signature for posts originating from the Groups.io website.
use_signature_email optional boolean	Whether to use the signature for posts originated from email.
chat_msg_notify optional string	Notify when someone posts a message to a chat you are subscribed to, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
like_notify optional string	Notify when someone likes a message you posted, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
The following are ignored if the subscription `mod_status` is `mod_status_none`.
pending_msg_notify optional string	Notify about pending messages, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
pending_sub_notify optional string	Notify about pending subscriptions, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
sub_notify optional string	Notify when someone joins the group, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
storage_notify optional string	Notify when storage limits are reached, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
sub_group_notify optional string	Notify when a subgroup is created, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
message_report_notify optional string	Notify when someone reports a message, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
chat_notify optional string	Notify when someone starts a chat, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
photo_notify optional string	Notify when someone creates a photo album or uploads a photo, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
file_notify optional string	Notify when someone creates a folder or uploads a file, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
wiki_notify optional string	Notify when someone creates or modifies a wiki page, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
database_notify optional string	Notify when someone creates or modifies a database, can be: `sub_notify_email_and_app`, `sub_notify_app_only`, `sub_notify_email_only`, `sub_notify_none`
owner_msg_notify optional string	Receive messages sent to the +owner address, can be `sub_ownermsg_notify_all`, `sub_ownermsg_notify_subs`, `sub_ownermsg_notify_none`
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a member info object if the update succeeded. Returns an error if update parameters are invalid (e.g. specifying an invalid parameter). Below are the unique errors to this call.

Additional Errors

Notes

If email_delivery is switched from either email_delivery_digest or email_delivery_html_digest to one of the non-digest options, and there are pending digest messages, a digest will be generated at this time.

GET /api/v1/updatesub
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatesub" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/updatesub", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatesub', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

View Member Info definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Subscription

Delete a subscription.

POST Parameters

group_id required	ID of the group from which you wish to unsubscribe.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an error if update parameters are invalid (e.g. specifying an invalid group name). Below are the unique errors to this call.

Additional Errors

bad_request	"you are the only owner" is returned if you are the only owner of the group.

Notes

Every group must have at least one owner. If you are the only owner of the group, you cannot delete your subscription.

POST /api/v1/deletesub
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletesub" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=2"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "2")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletesub",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '2'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletesub', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

These are the API endpoints for wikis.

New Wiki Page

Create a new wiki page. The wiki page is created.

Permissions Needed

You must have the manage_wiki permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
title required string	The title of the wiki page.
body required string	The body of the wiki page, in HTML format.
locked optional boolean	If the page should be locked.
edit_msg optional string	An edit message.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a wiki page set object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid title" is returned if the title is missing or invalid.
"bad_request"	"invalid body" is returned if the body is missing or invalid.
"bad_request"	"duplicate title" is returned if the title is a duplicate of another wiki page.

POST /api/v1/newwikipage
cURL
Go
JavaScript

curl "https://groups.io/api/v1/newwikipage" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "body=testing" \
  -d "group_id=12" \
  -d "title=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("body", "testing")
    data.Set("group_id", "12")
    data.Set("title", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/newwikipage",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'body': 'testing',
            'group_id': '12',
            'title': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/newwikipage', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "page": {
     "id": 52691321,
     "object": "wiki_page",
     "created": "2020-09-15T02:30:00-07:00",
     "updated": "2021-03-01T18:07:00-08:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "title": "Including tribe anything from whose market",
     "path": "Including-tribe-anything-from-whose-market",
     "locked": false,
     "rev_count": 43
   },
   "data": {
     "id": 189165006,
     "object": "wiki_data",
     "created": "2020-09-14T08:42:00-07:00",
     "updated": "2022-07-09T08:28:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Any it such so annually myself cloud these Lebanese Guyanese you herself. Greatly one being nest when itself yet unless outfit were anybody these. It envy sit too consequently which egg lastly correctly is hand early. You moreover seed those someone daily to them backwards this that provided. Store elegance joy group Senegalese whichever happen trade move outside downstairs of.\u003cbr/\u003eExemplified up out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for her our. Much nevertheless which numerous alone bevy as by from e.g. otherwise laptop. Cloud then them yourselves few look fleet say still patrol finally Vietnamese. Painting otherwise its to a e.g. congregation cackle themselves previously in for.\u003cbr/\u003eTheirs they my there road disappear accordingly hotel so today by over. Have this Romanian abroad around while belong ever into each whatever fortnightly. He agreeable sari anyone therefore does could exaltation of sit everyone they. Had mustering would as yesterday we inquire ourselves his laugh string several. Accordingly kindness bit stand woman just poised they enough thing homework each.",
     "edit_msg": "Clothing other cry"
   },
   "sidebar": {
     "id": 126768040,
     "object": "wiki_data",
     "created": "2020-09-06T17:44:00-07:00",
     "updated": "2021-07-07T18:15:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Those line over elegantly say woman pen today as now ourselves first. For without what might any where as out me were Norwegian significant. His do mob notice lastly theirs hotel one calm that later does. Point throw neatly usually Kazakh without for one from soon swing whose. Man confusing case Bangladeshi how most somewhat several week e.g. who earlier.\u003cbr/\u003eGentle catalog ourselves then tonight bend may yearly since limit e.g. besides. Chest their hair out work data sedge this might how group out. Then result these preen numerous on frequently him at tonight is seriously. Why kiss logic beyond him swing our Amazonian will for myself everybody. I abundant few weekly anyone an weekly someone being that her enthusiasm.\u003cbr/\u003eYours never without theirs mine that delay that the air whatever bundle. You is such batch accommodation without now in yearly adventurous her for. Previously as of along nobody back hers numerous would our bra yours. Union Bangladeshi Bahamian now wiggle should our example eye woman in religion. Am collapse regiment in were choir troop speed throw year work let.",
     "edit_msg": "Bunch one choir those horror would is"
   },
   "footer": {
     "id": 9000308,
     "object": "wiki_data",
     "created": "2020-09-06T02:40:00-07:00",
     "updated": "2020-10-07T01:03:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Close disregard completely decidedly which exaltation decidedly think niche annoyance yesterday hence. As him his this one into this she choir they of him. Some calm that engine our capture it that infrequently accordingly something with. Adult last often finally tonight congregation of so sneeze care massage it. Road behind recently Atlantic tea difficult were another his then afterwards finally.\u003cbr/\u003eHimself I yearly by them yet from after whom ream when fortnightly. Whose dark why besides aunt what caravan Icelandic Shakespearean theirs point spotted. Those but clap really now ourselves there rice Burmese graceful say cloud. So secondly besides moreover her sadly later several listen example answer that. Under below peacock Roman despite herself ring early outfit what are fatally.\u003cbr/\u003eRice which the door him how regularly any any key often crew. Talent it theirs disregard theirs his regularly bunch according next for French. Pretty yourselves that nutrition disregard he distinguish bones your usually as quarterly. Fondly dress pleasure ourselves my that party begin close frightening accordingly still. She outside smell hourly union anyone him leap long as had pancake.",
     "edit_msg": "Any annually gang dream without might may"
   }
}

View Wiki Page Set definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Update Wiki Page

Update an existing wiki page.

Permissions Needed

You must have the manage_wiki permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
id required number	ID of the wiki page.
title optional string	The title of the wiki page.
body optional string	The body of the wiki page, in HTML format.
locked optional boolean	If the page should be locked.
edit_msg optional string	An edit message.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a wiki page set object. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid id" is returned if the id is missing or invalid.
"bad_request"	"invalid title" is returned if the title is missing or invalid.
"bad_request"	"invalid body" is returned if the body is missing or invalid.
"bad_request"	"duplicate title" is returned if the title is a duplicate of another wiki page.

POST /api/v1/updatewikipage
cURL
Go
JavaScript

curl "https://groups.io/api/v1/updatewikipage" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "body=testing" \
  -d "group_id=12" \
  -d "title=Test"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("body", "testing")
    data.Set("group_id", "12")
    data.Set("title", "Test")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/updatewikipage",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'body': 'testing',
            'group_id': '12',
            'title': 'Test'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/updatewikipage', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "page": {
     "id": 52691321,
     "object": "wiki_page",
     "created": "2020-09-15T02:30:00-07:00",
     "updated": "2021-03-01T18:07:00-08:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "title": "Including tribe anything from whose market",
     "path": "Including-tribe-anything-from-whose-market",
     "locked": false,
     "rev_count": 43
   },
   "data": {
     "id": 189165006,
     "object": "wiki_data",
     "created": "2020-09-14T08:42:00-07:00",
     "updated": "2022-07-09T08:28:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Any it such so annually myself cloud these Lebanese Guyanese you herself. Greatly one being nest when itself yet unless outfit were anybody these. It envy sit too consequently which egg lastly correctly is hand early. You moreover seed those someone daily to them backwards this that provided. Store elegance joy group Senegalese whichever happen trade move outside downstairs of.\u003cbr/\u003eExemplified up out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for her our. Much nevertheless which numerous alone bevy as by from e.g. otherwise laptop. Cloud then them yourselves few look fleet say still patrol finally Vietnamese. Painting otherwise its to a e.g. congregation cackle themselves previously in for.\u003cbr/\u003eTheirs they my there road disappear accordingly hotel so today by over. Have this Romanian abroad around while belong ever into each whatever fortnightly. He agreeable sari anyone therefore does could exaltation of sit everyone they. Had mustering would as yesterday we inquire ourselves his laugh string several. Accordingly kindness bit stand woman just poised they enough thing homework each.",
     "edit_msg": "Clothing other cry"
   },
   "sidebar": {
     "id": 126768040,
     "object": "wiki_data",
     "created": "2020-09-06T17:44:00-07:00",
     "updated": "2021-07-07T18:15:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Those line over elegantly say woman pen today as now ourselves first. For without what might any where as out me were Norwegian significant. His do mob notice lastly theirs hotel one calm that later does. Point throw neatly usually Kazakh without for one from soon swing whose. Man confusing case Bangladeshi how most somewhat several week e.g. who earlier.\u003cbr/\u003eGentle catalog ourselves then tonight bend may yearly since limit e.g. besides. Chest their hair out work data sedge this might how group out. Then result these preen numerous on frequently him at tonight is seriously. Why kiss logic beyond him swing our Amazonian will for myself everybody. I abundant few weekly anyone an weekly someone being that her enthusiasm.\u003cbr/\u003eYours never without theirs mine that delay that the air whatever bundle. You is such batch accommodation without now in yearly adventurous her for. Previously as of along nobody back hers numerous would our bra yours. Union Bangladeshi Bahamian now wiggle should our example eye woman in religion. Am collapse regiment in were choir troop speed throw year work let.",
     "edit_msg": "Bunch one choir those horror would is"
   },
   "footer": {
     "id": 9000308,
     "object": "wiki_data",
     "created": "2020-09-06T02:40:00-07:00",
     "updated": "2020-10-07T01:03:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Close disregard completely decidedly which exaltation decidedly think niche annoyance yesterday hence. As him his this one into this she choir they of him. Some calm that engine our capture it that infrequently accordingly something with. Adult last often finally tonight congregation of so sneeze care massage it. Road behind recently Atlantic tea difficult were another his then afterwards finally.\u003cbr/\u003eHimself I yearly by them yet from after whom ream when fortnightly. Whose dark why besides aunt what caravan Icelandic Shakespearean theirs point spotted. Those but clap really now ourselves there rice Burmese graceful say cloud. So secondly besides moreover her sadly later several listen example answer that. Under below peacock Roman despite herself ring early outfit what are fatally.\u003cbr/\u003eRice which the door him how regularly any any key often crew. Talent it theirs disregard theirs his regularly bunch according next for French. Pretty yourselves that nutrition disregard he distinguish bones your usually as quarterly. Fondly dress pleasure ourselves my that party begin close frightening accordingly still. She outside smell hourly union anyone him leap long as had pancake.",
     "edit_msg": "Any annually gang dream without might may"
   }
}

View Wiki Page Set definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Wiki Page

Delete an existing wiki page.

Permissions Needed

You must have the manage_wiki permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
id required number	ID of the wiki page.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid id" is returned if the id is missing or invalid.

POST /api/v1/deletewikipage
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletewikipage" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "group_id=12" \
  -d "id=10"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("group_id", "12")
    data.Set("id", "10")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletewikipage",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'group_id': '12',
            'id': '10'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletewikipage', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Delete Wiki Page Revision

Delete an existing wiki page revision.

Permissions Needed

You must have the manage_wiki permission to use this call with a group.

POST Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
id required number	ID of the wiki page.
data_id required number	ID of the wiki data object to delete.
csrf required string	The `csrf_token` from the user object returned when first logged in.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns HTTP 200 on success. Returns an error if parameters are invalid (e.g. specifying an invalid group_id). Below are the unique errors to this call.a

Additional Errors

"bad_request"	"invalid group_id" is returned if the group id is missing or invalid.
"bad_request"	"invalid id" is returned if the id is missing or invalid.
"bad_request"	"invalid data_id" is returned if the data_id is missing or invalid.

POST /api/v1/deletewikirevision
cURL
Go
JavaScript

curl "https://groups.io/api/v1/deletewikirevision" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d "data_id=1" \
  -d "group_id=12" \
  -d "id=10"

package main

import (
    "fmt"
    "io"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    data := url.Values{}
    data.Set("data_id", "1")
    data.Set("group_id", "12")
    data.Set("id", "10")

    req, err := http.NewRequest("POST", "https://groups.io/api/v1/deletewikirevision",
        strings.NewReader(data.Encode()))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

async function callAPI() {
    const options = {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY',
            'Content-Type': 'application/x-www-form-urlencoded'
        },
        body: new URLSearchParams({
            'data_id': '1',
            'group_id': '12',
            'id': '10'
        }).toString()
    };

    try {
        const response = await fetch('https://groups.io/api/v1/deletewikirevision', options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Successful Response

HTTP 200

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Wiki Pages

Get a list of all wiki pages. Pages are returned using the pagination request and object format.

Permissions Needed

You must have the wiki_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are: `title`, `created`.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns an wiki page list object if successful. Returns an error if there is an error.

Additional Errors

No additional errors

GET /api/v1/getwikipages
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getwikipages?group_id=12" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getwikipages?group_id=12", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getwikipages');
    url.searchParams.append('group_id', '12');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "wiki_page",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "title": "Including tribe anything from whose",
       "path": "Including-tribe-anything-from-whose",
       "locked": false,
       "rev_count": 30
     },
     {
       "id": 29743360,
       "object": "wiki_page",
       "created": "2020-10-01T09:06:00-07:00",
       "updated": "2022-06-06T16:00:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "title": "Yourself any it such so",
       "path": "Yourself-any-it-such-so",
       "locked": false,
       "rev_count": 37
     },
     {
       "id": 83034458,
       "object": "wiki_page",
       "created": "2020-09-14T20:59:00-07:00",
       "updated": "2022-11-29T01:40:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "title": "E.g. fear usually",
       "path": "E.g.-fear-usually",
       "locked": false,
       "rev_count": 1
     }
   ]
}

View Wiki Page List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Get Wiki Page Set

Get wiki page set.

Permissions Needed

You must have the wiki_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` must be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` must be specified.
path required string	Path of wiki page. Either `path` or `id` must be specified.
id required number	ID of the wiki page to fetch. Either `path` or `id` must be specified.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a wiki_page_set object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"invalid path" is returned if the path is invalid.
"bad_request"	"invalid id" is returned if the id is invalid.
"bad_request"	"missing path and id" is returned if neither the path or id are specified.

Notes

GET /api/v1/getwikipageset
cURL
Go
JavaScript

curl "https://groups.io/api/v1/getwikipageset?group_id=12&path=test" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/getwikipageset?group_id=12&path=test", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/getwikipageset');
    url.searchParams.append('group_id', '12');
    url.searchParams.append('path', 'test');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
   "page": {
     "id": 52691321,
     "object": "wiki_page",
     "created": "2020-09-15T02:30:00-07:00",
     "updated": "2021-03-01T18:07:00-08:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "title": "Including tribe anything from whose market",
     "path": "Including-tribe-anything-from-whose-market",
     "locked": false,
     "rev_count": 43
   },
   "data": {
     "id": 189165006,
     "object": "wiki_data",
     "created": "2020-09-14T08:42:00-07:00",
     "updated": "2022-07-09T08:28:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Any it such so annually myself cloud these Lebanese Guyanese you herself. Greatly one being nest when itself yet unless outfit were anybody these. It envy sit too consequently which egg lastly correctly is hand early. You moreover seed those someone daily to them backwards this that provided. Store elegance joy group Senegalese whichever happen trade move outside downstairs of.\u003cbr/\u003eExemplified up out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for her our. Much nevertheless which numerous alone bevy as by from e.g. otherwise laptop. Cloud then them yourselves few look fleet say still patrol finally Vietnamese. Painting otherwise its to a e.g. congregation cackle themselves previously in for.\u003cbr/\u003eTheirs they my there road disappear accordingly hotel so today by over. Have this Romanian abroad around while belong ever into each whatever fortnightly. He agreeable sari anyone therefore does could exaltation of sit everyone they. Had mustering would as yesterday we inquire ourselves his laugh string several. Accordingly kindness bit stand woman just poised they enough thing homework each.",
     "edit_msg": "Clothing other cry"
   },
   "sidebar": {
     "id": 126768040,
     "object": "wiki_data",
     "created": "2020-09-06T17:44:00-07:00",
     "updated": "2021-07-07T18:15:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Those line over elegantly say woman pen today as now ourselves first. For without what might any where as out me were Norwegian significant. His do mob notice lastly theirs hotel one calm that later does. Point throw neatly usually Kazakh without for one from soon swing whose. Man confusing case Bangladeshi how most somewhat several week e.g. who earlier.\u003cbr/\u003eGentle catalog ourselves then tonight bend may yearly since limit e.g. besides. Chest their hair out work data sedge this might how group out. Then result these preen numerous on frequently him at tonight is seriously. Why kiss logic beyond him swing our Amazonian will for myself everybody. I abundant few weekly anyone an weekly someone being that her enthusiasm.\u003cbr/\u003eYours never without theirs mine that delay that the air whatever bundle. You is such batch accommodation without now in yearly adventurous her for. Previously as of along nobody back hers numerous would our bra yours. Union Bangladeshi Bahamian now wiggle should our example eye woman in religion. Am collapse regiment in were choir troop speed throw year work let.",
     "edit_msg": "Bunch one choir those horror would is"
   },
   "footer": {
     "id": 9000308,
     "object": "wiki_data",
     "created": "2020-09-06T02:40:00-07:00",
     "updated": "2020-10-07T01:03:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Close disregard completely decidedly which exaltation decidedly think niche annoyance yesterday hence. As him his this one into this she choir they of him. Some calm that engine our capture it that infrequently accordingly something with. Adult last often finally tonight congregation of so sneeze care massage it. Road behind recently Atlantic tea difficult were another his then afterwards finally.\u003cbr/\u003eHimself I yearly by them yet from after whom ream when fortnightly. Whose dark why besides aunt what caravan Icelandic Shakespearean theirs point spotted. Those but clap really now ourselves there rice Burmese graceful say cloud. So secondly besides moreover her sadly later several listen example answer that. Under below peacock Roman despite herself ring early outfit what are fatally.\u003cbr/\u003eRice which the door him how regularly any any key often crew. Talent it theirs disregard theirs his regularly bunch according next for French. Pretty yourselves that nutrition disregard he distinguish bones your usually as quarterly. Fondly dress pleasure ourselves my that party begin close frightening accordingly still. She outside smell hourly union anyone him leap long as had pancake.",
     "edit_msg": "Any annually gang dream without might may"
   }
}

View Wiki Page Set definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Search Wikis

Search the wiki.

Permissions Needed

You must have the wiki_visible permission to use this call with a group.

Query Parameters

group_id required number	ID of the group. Either `group_id` or `group_name` can be specified.
group_name required string	Name of the group. Either `group_id` or `group_name` can be specified.
q required string	The query string.
limit optional default is 10	A limit on the number of objects to be returned, between 1 and 100.
page_token optional	A cursor for use in pagination. To fetch the next page, set `page_token` to the value of the `next_page_token` response.
sort_field optional string	The field to sort on. Valid values are dependent on the call.
sort_dir optional string	Sort direction. Can be `asc` or `desc`.
extended optional boolean	If `true`, the endpoint will return additional information. See Extended Return Information for more information.

Returns

Returns a wiki_search_results_list object if successful. Returns an error if there is an error.

Additional Errors

"bad_request"	"missing query" is returned if the q parameter is not specified.

GET /api/v1/searchwikis
cURL
Go
JavaScript

curl "https://groups.io/api/v1/searchwikis?group_id=12&q=find+this" \
  -H "Authorization: Bearer YOUR_API_KEY"

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://groups.io/api/v1/searchwikis?group_id=12&q=find+this", nil)
    if err != nil {
        panic(err)
    }

    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

// Node.js example - for browser, fetch is already available

async function callAPI() {
    const url = new URL('https://groups.io/api/v1/searchwikis');
    url.searchParams.append('group_id', '12');
    url.searchParams.append('q', 'find+this');

    const options = {
        method: 'GET',
        headers: {
            'Authorization': 'Bearer YOUR_API_KEY'
        }
    };

    try {
        const response = await fetch(url, options);
        const data = await response.json();
        console.log(data);
    } catch (error) {
        console.error('Error:', error);
    }
}

callAPI();

Example Successful Response

 {
 "object": "list",
 "total_count": 54,
 "start_item": 57,
 "end_item": 4,
 "has_more": false,
 "next_page_token": 92,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "group_id": 6,
 "query": "",
 "data": [
   {
    "id": 65,
    "object": "wiki_search_result",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 21,
    "group_id": 57,
    "data_id": 30,
    "title": "",
    "rev_count": 42,
    "body": "",
    "edit_msg": "",
    "snippet": "",
   }
 ],
}

View Wiki Search Results List definition

Example Error Response

 {
     "object": "error",
     "type": "inadequate_permissions",
     "extra": ""
 }

Calls can return an object, or a list of objects, which can be paged through. Every object has an object parameter which identifies the object. Lists of objects also have an object parameter, set to list.

The Activity Log Object

The activity log object. This represents an entry in the group activity log.

Response Attributes

id number	ID of the draft attachment object.
object string	activity_log.
created date
group_id number	ID of the group.
entry string	The log entry, in HTML format.
via string	How the log entry was generated. Can be one of: `via_api`, `via_app`, `via_email`, `via_robot`, `via_slacksync`, `via_support`, `via_web`.

Example Object

{
   "id": 52691321,
   "object": "activity_log",
   "created": "2020-09-15T02:30:00-07:00",
   "group_id": 8658933,
   "entry": "Integration \"testintegration\" sent  special notice #32",
   "via": "via_robot"
}

The Activity Log List Object

Activity Log List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Activity Log objects

Methods That Use This Object

Get Activity Log	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "activity_log",
       "created": "2020-09-02T00:51:00-07:00",
       "group_id": 8658933,
       "entry": "Integration \"testintegration\" sent  special notice #0",
       "via": "via_robot"
     },
     {
       "id": 10192753,
       "object": "activity_log",
       "created": "2020-08-30T23:30:00-07:00",
       "group_id": 8658933,
       "entry": "Integration \"testintegration\" sent  special notice #1",
       "via": "via_robot"
     },
     {
       "id": 122478329,
       "object": "activity_log",
       "created": "2020-10-01T15:33:00-07:00",
       "group_id": 8658933,
       "entry": "Integration \"testintegration\" sent  special notice #2",
       "via": "via_robot"
     }
   ]
}

The Add Error Object

The direct add results error object.

Response Attributes

object string	direct_add_error.
email string
alias_of string
status string	utils.DirectAddStatus.
group_id number

Example Object

{
 "object": "direct_add_error",
 "email": "",
 "alias_of": "",
 "status": "",
 "group_id": 60,
}

The Album Object

The album object.

Response Attributes

id number	Unique ID of the album object.
object string	album.
created date
updated date
user_id number
group_id number
upload_perms string
title string	Title of the album.
desc string	Description of the album in plain text.
display_name string	Name of the person who uploaded the photo.
user_name string	User name of the person who uploaded the photo.
profile_photo_url optional string	URL of the profile photo of the person who uploaded the photo.
profile_privacy string	Privacy setting of the person who uploaded the photo.
email string	Possibly obscured, depending on group settings.
cover_photo_thumbnail_url optional string	Thumbnail of cover photo.
cover_photo_url optional string	Photo to display.
total_photos optional number	How many photos in album.

Methods That Use This Object

New Photo Album	View Method
Update Photo Album	View Method
Update Photo	View Method

Example Object

{
   "id": 52691321,
   "object": "album",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "upload_perms": "album_upload_group",
   "title": "Including tribe anything from whose market",
   "desc": "Pyramid accordingly onto moreover whenever e.g. fear usually body kilometer. Nightly child so firstly he next each secondly must catch. Politely sleepy where i.e. inquisitively yours wisp regularly nice cackle. Ourselves heavily now this our yearly what few why where. Win most would everybody them backwards this that provided store.",
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@...",
   "total_photos": 24
}

The Album List Object

Album List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Album objects

Methods That Use This Object

Get Photo Albums	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "album",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "upload_perms": "album_upload_group",
       "title": "Including tribe anything from whose",
       "desc": "Market pyramid accordingly onto moreover whenever e.g. fear usually body. Kilometer nightly child so firstly he next each secondly must. Catch politely sleepy where i.e. inquisitively yours wisp regularly nice. Cackle ourselves heavily now this our yearly what few why. Where win most would everybody them backwards this that provided.",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "total_photos": 18
     },
     {
       "id": 134723079,
       "object": "album",
       "created": "2020-10-01T09:06:00-07:00",
       "updated": "2022-06-06T16:00:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "upload_perms": "album_upload_group",
       "title": "Whom I company Roman indeed",
       "desc": "Words trade move outside downstairs of exemplified up out destroy. Due taste anything where this that would whom to cautiously. Till only himself fight our whomever that for her our. Much nevertheless which numerous alone bevy as by from e.g.. Otherwise laptop cloud then them yourselves few look fleet say.",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "total_photos": 27
     },
     {
       "id": 112832928,
       "object": "album",
       "created": "2020-09-14T20:59:00-07:00",
       "updated": "2022-11-29T01:40:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "upload_perms": "album_upload_group",
       "title": "Cruelly rarely over",
       "desc": "By otherwise its to a e.g. congregation cackle themselves previously. In for theirs they my there road disappear accordingly hotel. So today by over have this Romanian abroad around while. Belong ever into each whatever fortnightly he agreeable sari anyone. Therefore does could exaltation of sit everyone they had mustering.",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "total_photos": 13
     }
   ]
}

The Attachment Object

Attachment information. Attachments have a media type. From that, you can determine the type of attachment it is. If the attachment is an image, the image_thumbnail_url is set.

Response Attributes

id number	The ID of the attachment.
media_type string	The media type of the attachment, lowercased.
download_url string	URL to download the attachment.
image_thumbnail_url string	If this is an image, the URL to get the image thumbnail for display.
filename string	The filename of the attachment.

Example Object

{
 "id": 39,
 "media_type": "",
 "download_url": "",
 "image_thumbnail_url": "",
 "filename": "",
}

The Attachment Object

The Attachment object contains all the data required for displaying an image attachment.

Response Attributes

id string
object string	attachment.
created date
group_id number
user_id number	Who originally created this table.
thread_id number
message_num number
attach_num number
type string
sub_type string
name string
content string
image_width number
image_height number
thumbnail_url string

Example Object

{
 "id": "",
 "object": "attachment",
 "created": "2009-11-10T15:00:00-08:00",
 "group_id": 31,
 "user_id": 19,
 "thread_id": 73,
 "message_num": 39,
 "attach_num": 75,
 "type": "",
 "sub_type": "",
 "name": "",
 "content": "",
 "image_width": 9,
 "image_height": 97,
 "thumbnail_url": "",
}

The Bounce Info Object

The bounce info object.

Response Attributes

object string	bounce_info.
created date
group_id number	ID of the group.
msg_id number	Message ID of the message we were attempting to send.
subject string	Subject of the message we were attempting to send.
response string	Response from the recipient server.
is_hard boolean	If the bounce was a hard bounce.
type string	Can be one of: `delivery_bounce_probe`, `delivery_confirmation`, `delivery_digest`, `delivery_direct_add`, `delivery_invite`, `delivery_login_link`, `delivery_member_notice`, `delivery_mod_notice`, `delivery_reply`, `delivery_reverify`, `delivery_single`, `delivery_summary`, `delivery_to_owner`, `delivery_to_sub`.

Example Object

{
 "object": "bounce_info",
 "created": "2009-11-10T15:00:00-08:00",
 "group_id": 1,
 "msg_id": 19,
 "subject": "",
 "response": "",
 "is_hard": false,
 "type": "delivery_bounce_probe",
}

The Bounce Info List Object

Bounce Info List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Bounce Info objects

Methods That Use This Object

Get Bounce Info	View Method

Example Object

{
 "object": "list",
 "total_count": 41,
 "start_item": 3,
 "end_item": 62,
 "has_more": false,
 "next_page_token": 83,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "object": "bounce_info",
    "created": "2009-11-10T15:00:00-08:00",
    "group_id": 83,
    "msg_id": 72,
    "subject": "",
    "response": "",
    "is_hard": false,
    "type": "delivery_bounce_probe",
   }
 ],
}

The Chat Object

The chat object.

Response Attributes

id number	Unique ID of the chat object.
object string	chat.
created date
updated date
user_id number	ID of the person who created the chat.
profile_photo_url string	If not empty then there is a profile photo associated with this votor.
name string	Name of the person who voted.
can_view_profile boolean	If the person viewing this poll can view the profile.
group_id number	ID of the group the chat is in.
subject string
desc string
is_closed boolean
num_messages number
chat_sub optional Chat Sub object	If the calling person is subscribed to this chat, this is their subscription.

Methods That Use This Object

New Chat	View Method
Update Chat	View Method

Example Object

{
   "id": 52691321,
   "object": "chat",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "profile_photo_url": "",
   "name": "",
   "can_view_profile": false,
   "group_id": 8658933,
   "subject": "Including.",
   "desc": "Tribe anything from.",
   "is_closed": false,
   "num_messages": 21,
   "chat_sub": {
     "id": 179889653,
     "object": "chat_sub",
     "created": "2020-09-10T11:42:00-07:00",
     "updated": "2023-03-29T23:48:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "chat_id": 52691321,
     "last_msg_seen": 40
   }
}

The Chat List Object

Chat List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Chat objects

Methods That Use This Object

Get Chats	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "chat",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
       "group_id": 8658933,
       "subject": "Including.",
       "desc": "Tribe anything from.",
       "is_closed": false,
       "num_messages": 21,
       "chat_sub": {
         "id": 179889653,
         "object": "chat_sub",
         "created": "2020-09-29T17:03:00-07:00",
         "updated": "2022-06-18T23:30:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "chat_id": 52691321,
         "last_msg_seen": 40
       }
     },
     {
       "id": 195168922,
       "object": "chat",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
       "group_id": 8658933,
       "subject": "Pyramid.",
       "desc": "Accordingly onto moreover.",
       "is_closed": false,
       "num_messages": 81,
       "chat_sub": {
         "id": 83034458,
         "object": "chat_sub",
         "created": "2020-09-06T02:40:00-07:00",
         "updated": "2020-10-07T01:03:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "chat_id": 195168922,
         "last_msg_seen": 90
       }
     },
     {
       "id": 182971401,
       "object": "chat",
       "created": "2020-09-24T00:10:00-07:00",
       "updated": "2021-05-19T19:29:00-07:00",
       "user_id": 147779411,
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
       "group_id": 8658933,
       "subject": "Fear.",
       "desc": "Usually body kilometer.",
       "is_closed": false,
       "num_messages": 198,
       "chat_sub": {
         "id": 122478329,
         "object": "chat_sub",
         "created": "2020-08-30T21:35:00-07:00",
         "updated": "2023-05-02T01:56:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "chat_id": 182971401,
         "last_msg_seen": 84
       }
     }
   ]
}

The Chat Message Object

The chat message object. A chat message is a posted message to a chat room.

Response Attributes

id number	Unique ID of the chat_message object.
object string	chat_message.
created date
version number	The version of this object. Used to detect server upgrades to force reload of the app. The current version is 2.
user_id number	ID of the person who is subscribed.
group_id number	ID of the group the chat is in.
chat_id number	ID of the chat.
type string	Type of message. Can be one of: `chat_msg_type_blur`, `chat_msg_type_closed`, `chat_msg_type_delete`, `chat_msg_type_first`, `chat_msg_type_focus`, `chat_msg_type_joined`, `chat_msg_type_left`, `chat_msg_type_normal`, `chat_msg_type_photo`, `chat_msg_type_removed`, `chat_msg_type_update_tapbacks`, `chat_msg_type_video`.
message string	The chat message itself (dependant on the Type of chat message), in HTML format.
msg_num number	The message number, increases monotonically from 1.
reply_message optional Chat Message object	If this message is a reply, this is the message that it's replying to.
delete_msg_num number	If this is a delete message, this is the ID to delete.
media array of Chat Message Media objects
tapbacks array of Chat Message Tapback objects
tapback_counts array of Chat Message Tapback Count objects
display_name string
user_name string
profile_photo_url string
profile_privacy string	Privacy setting of the sender of the message.
profile_color string	Color to use when displaying the sender's name, in hex.
email string	Possibly obscured, depending on group settings.

Example Object

{
   "id": 179889653,
   "object": "chat_message",
   "created": "2020-09-10T11:42:00-07:00",
   "version": 5,
   "user_id": 147779411,
   "group_id": 8658933,
   "chat_id": 52691321,
   "type": "chat_msg_type_normal",
   "message": "Market pyramid accordingly onto moreover whenever e.g. fear..",
   "msg_num": 179889653,
   "delete_msg_num": 0,
   "media": null,
   "tapbacks": null,
   "tapback_counts": null,
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_photo_url": "https://picsum.photos/id/53/498/325",
   "profile_privacy": "profile_private",
   "profile_color": "#837fd5",
   "email": "gersonbeahan@..."
}

The Chat Message List Object

Chat Message List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Chat Message objects

Methods That Use This Object

Get Chat History	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 179889653,
       "object": "chat_message",
       "created": "2020-09-29T17:03:00-07:00",
       "version": 5,
       "user_id": 147779411,
       "group_id": 8658933,
       "chat_id": 52691321,
       "type": "chat_msg_type_normal",
       "message": "Market pyramid..",
       "msg_num": 179889653,
       "delete_msg_num": 0,
       "media": null,
       "tapbacks": [
         {
           "user_id": 51506187,
           "sub_id": 14243141,
           "type": "chat_msg_tapback_thumbs_up"
         },
         {
           "user_id": 97752942,
           "sub_id": 10287162,
           "type": "chat_msg_tapback_laugh"
         }
       ],
       "tapback_counts": [
         {
           "type": "chat_msg_tapback_heart",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_thumbs_up",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_thumbs_down",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_laugh",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_exclamation",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_question",
           "count": 0
         }
       ],
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://picsum.photos/id/53/498/325",
       "profile_privacy": "profile_private",
       "profile_color": "#837fd5",
       "email": "gersonbeahan@..."
     },
     {
       "id": 154675724,
       "object": "chat_message",
       "created": "2020-09-14T23:24:00-07:00",
       "version": 5,
       "user_id": 147779411,
       "group_id": 8658933,
       "chat_id": 10192753,
       "type": "chat_msg_type_normal",
       "message": "Lebanese Guyanese you herself greatly one being nest. When itself yet unless outfit were anybody these.",
       "msg_num": 154675724,
       "delete_msg_num": 0,
       "media": null,
       "tapbacks": [
         {
           "user_id": 196646336,
           "sub_id": 144338940,
           "type": "chat_msg_tapback_question"
         },
         {
           "user_id": 123317449,
           "sub_id": 174167102,
           "type": "chat_msg_tapback_heart"
         },
         {
           "user_id": 115712626,
           "sub_id": 20535086,
           "type": "chat_msg_tapback_thumbs_down"
         },
         {
           "user_id": 92539812,
           "sub_id": 54982055,
           "type": "chat_msg_tapback_thumbs_down"
         },
         {
           "user_id": 110808615,
           "sub_id": 161817060,
           "type": "chat_msg_tapback_laugh"
         },
         {
           "user_id": 89933098,
           "sub_id": 19594331,
           "type": "chat_msg_tapback_heart"
         }
       ],
       "tapback_counts": [
         {
           "type": "chat_msg_tapback_heart",
           "count": 2
         },
         {
           "type": "chat_msg_tapback_thumbs_up",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_thumbs_down",
           "count": 2
         },
         {
           "type": "chat_msg_tapback_laugh",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_exclamation",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_question",
           "count": 1
         }
       ],
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://picsum.photos/id/53/498/325",
       "profile_privacy": "profile_private",
       "profile_color": "#837fd5",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "chat_message",
       "created": "2020-09-20T09:51:00-07:00",
       "version": 5,
       "user_id": 147779411,
       "group_id": 8658933,
       "chat_id": 137070462,
       "type": "chat_msg_type_normal",
       "message": "What few why where win most would everybody them backwards this that. Provided store elegance joy group Senegalese whichever happen trade move outside downstairs. Of exemplified up out destroy due taste anything where this that would. Whom to cautiously till only himself fight our whomever that for her. Our much nevertheless which numerous alone bevy as by from e.g. otherwise. Laptop cloud then them yourselves few look fleet say still patrol finally. Vietnamese painting otherwise its to a e.g. congregation cackle themselves previously in. For theirs they my there road disappear accordingly hotel so today by. Over have this Romanian abroad around while belong ever into each whatever.",
       "msg_num": 189377967,
       "delete_msg_num": 0,
       "media": null,
       "tapbacks": [
         {
           "user_id": 91729622,
           "sub_id": 141481456,
           "type": "chat_msg_tapback_laugh"
         },
         {
           "user_id": 55138761,
           "sub_id": 139522588,
           "type": "chat_msg_tapback_thumbs_up"
         }
       ],
       "tapback_counts": [
         {
           "type": "chat_msg_tapback_heart",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_thumbs_up",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_thumbs_down",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_laugh",
           "count": 1
         },
         {
           "type": "chat_msg_tapback_exclamation",
           "count": 0
         },
         {
           "type": "chat_msg_tapback_question",
           "count": 0
         }
       ],
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://picsum.photos/id/53/498/325",
       "profile_privacy": "profile_private",
       "profile_color": "#837fd5",
       "email": "gersonbeahan@..."
     }
   ]
}

The Chat Message Media Object

Chat Message Media

Response Attributes

name string	name of the photo or video.
type string	mime media type, if a photo or video.
size number
width number
height number
url string
gallery_url string

Example Object

{
 "name": "",
 "type": "",
 "size": 4,
 "width": 40,
 "height": 3,
 "url": "",
 "gallery_url": "",
}

The Chat Message Tapback Object

Chat Message Tapback

Response Attributes

user_id number
sub_id number
type string

Example Object

{
 "user_id": 89,
 "sub_id": 90,
 "type": "",
}

The Chat Message Tapback Count Object

Chat Message Tapback Count

Response Attributes

type string
count number

Example Object

{
 "type": "",
 "count": 6,
}

The Chat Sub Object

The chat subscription object.

Response Attributes

id number	Unique ID of the draft object.
object string	chat_sub.
created date
updated date
user_id number	ID of the person who is subscribed.
group_id number	ID of the group the chat is in.
chat_id number	ID of the chat.
last_msg_seen number	ID of the last chat_message msg_num seen by this subscriber.

Methods That Use This Object

Join Chat	View Method

Example Object

{
   "id": 179889653,
   "object": "chat_sub",
   "created": "2020-09-10T11:42:00-07:00",
   "updated": "2023-03-29T23:48:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "chat_id": 52691321,
   "last_msg_seen": 40
}

The Database Column Object

The database column object. This defines a specific database column.

Response Attributes

id number	Column ID.
name string	Name of the column.
type string	The column type. Can be one of: `address_column`, `checkbox_column`, `date_column`, `email_column`, `github_id_column`, `html_paragraph_column`, `image_column`, `link_column`, `multi_choice_column`, `multiple_choice_column`, `number_column`, `paragraph_column`, `text_column`, `time_column`.
required boolean	The column cannot be empty.
color string	Color of the row. Can be one of: `color_antique_pink`, `color_apricot`, `color_aquamute`, `color_beige`, `color_bluejean`, `color_blush`, `color_burnt_yellow`, `color_capri_blue`, `color_cerulean_blue`, `color_cherry_blossom`, `color_cloudy_blue`, `color_cucumber`, `color_dark_grey`, `color_dark_orange`, `color_dusty_mauve`, `color_emerald_green`, `color_grape`, `color_green_lantern`, `color_green_sage`, `color_grey_blue`, `color_light_brown`, `color_light_grey`, `color_light_lilac`, `color_lilac`, `color_lips`, `color_melon`, `color_military`, `color_moss_green`, `color_mulbery`, `color_mustard`, `color_none`, `color_orange`, `color_orchid`, `color_peony`, `color_pink`, `color_purple`, `color_purple_blue`, `color_purple_grey`, `color_sage`, `color_sky`, `color_terracotta`, `color_tomato`, `color_yellow`.
choices optional array of string	Titles of the choices for `multi_choice` and `multiple_choice` columns.
width number	Width of the column (0 means not set/use the default).
default_hidden boolean	The column should be hidden when you view the table initially.
profile optional boolean	If this column is a part of a member's profile, only used for extra member data columns.
description string	Description of this column.
default_country optional string	For address columns, the default country.
exclude_street optional boolean	For address columns, if we should exclude street fields.
exclude_city optional boolean	For address columns, if we should exclude the city field.
exclude_state optional boolean	For address columns, if we should exclude the state field.
exclude_zip optional boolean	For address columns, if we should exclude the zip field.
exclude_country optional boolean	For address columns, if we should exclude the country field.

Example Object

{
   "id": 52691321,
   "name": "Multiple Choice: Including tribe anything from whose.",
   "type": "multiple_choice_column",
   "required": true,
   "color": "color_orchid",
   "choices": [
     "Next each secondly must catch politely.",
     "Sleepy where i.e. inquisitively yours wisp.",
     "Regularly nice cackle ourselves heavily now."
   ],
   "width": 0,
   "default_hidden": false,
   "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
}

The Database Row Object

The database row object. This defines all the values in one row of a database.

Response Attributes

id number	Row ID.
object string	databaserow.
created date	Time that this row was first created.
updated date	Time that this row was last updated.
group_id number	ID of the group.
table_id number	ID of the `database_table` object.
row_num number	The table's max_row_id at the time of row creation.
vals array of Database Value objects	Values for each column.
num_vals number	Number of values.

Example Object

{
 "id": 63,
 "object": "databaserow",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 57,
 "table_id": 38,
 "row_num": 97,
 "vals": [
   {
    "col_id": 60,
    "col_type": "address_column",
    "text": "",
    "html_text": "",
    "date": "2009-11-10T15:00:00-08:00",
    "time": "2009-11-10T15:00:00-08:00",
    "checked": false,
    "multi_choice": [9],
    "street_address1": "",
    "street_address2": "",
    "city": "",
    "state": "",
    "zip": "",
    "country": "",
    "lat": "",
    "lng": "",
    "title": "",
    "url": "",
    "desc": "",
    "image_name": "",
    "image_data": [""],
    "number": "",
    "github_login": "",
    "github_name": "",
    "github_email": "",
    "github_avatar_url": "",
    "github_profile_url": "",
    "github_id": 3,
    "github_company": "",
    "github_location": "",
    "github_bio": "",
   }
 ],
 "num_vals": 96,
}

The Database Row List Object

Database Row List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Database Row objects

Methods That Use This Object

Get Database Rows	View Method

Example Object

{
 "object": "list",
 "total_count": 85,
 "start_item": 98,
 "end_item": 1,
 "has_more": false,
 "next_page_token": 25,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 88,
    "object": "databaserow",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 79,
    "table_id": 44,
    "row_num": 73,
    "vals": [
      {
       "col_id": 34,
       "col_type": "address_column",
       "text": "",
       "html_text": "",
       "date": "2009-11-10T15:00:00-08:00",
       "time": "2009-11-10T15:00:00-08:00",
       "checked": false,
       "multi_choice": [68],
       "street_address1": "",
       "street_address2": "",
       "city": "",
       "state": "",
       "zip": "",
       "country": "",
       "lat": "",
       "lng": "",
       "title": "",
       "url": "",
       "desc": "",
       "image_name": "",
       "image_data": [""],
       "number": "",
       "github_login": "",
       "github_name": "",
       "github_email": "",
       "github_avatar_url": "",
       "github_profile_url": "",
       "github_id": 18,
       "github_company": "",
       "github_location": "",
       "github_bio": "",
      }
    ],
    "num_vals": 96,
   }
 ],
}

The Database Table Object

The database table object.

Response Attributes

id number
object string	databasetable.
created date
updated date
group_id number
user_id number	Who originally created this table.
name string	Name of table.
short_desc string
desc string
desc_type string	html, plain, markdown.
edit_table string	Can be one of: `database_access_all`, `database_access_restricted`.
edit_rows string	Can be one of: `database_access_all`, `database_access_restricted`.
add_rows string	Can be one of: `database_access_all`, `database_access_restricted`.
view_table string	Can be one of: `database_access_all`, `database_access_restricted`.
num_rows number	Number of rows, not maintained automatically.
max_row_id number	For setting DatabaseRow.RowID, not maintained automatically.
num_columns number	Number of columns, automatically maintained.
max_col_id number	For setting unique column ids.
display_template string	Display template.
columns array of Database Column objects
id_default_hidden boolean	If the ID column should be hidden by default.
updated_default_hidden boolean	If the Updated column should be hidden by default.

Example Object

{
 "id": 21,
 "object": "databasetable",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 69,
 "user_id": 42,
 "name": "",
 "short_desc": "",
 "desc": "",
 "desc_type": "",
 "edit_table": "database_access_all",
 "edit_rows": "database_access_all",
 "add_rows": "database_access_all",
 "view_table": "database_access_all",
 "num_rows": 83,
 "max_row_id": 78,
 "num_columns": 10,
 "max_col_id": 74,
 "display_template": "",
 "columns": [
   {
      "id": 52691321,
      "name": "Multiple Choice: Including tribe anything from whose.",
      "type": "multiple_choice_column",
      "required": true,
      "color": "color_orchid",
      "choices": [
        "Next each secondly must catch politely.",
        "Sleepy where i.e. inquisitively yours wisp.",
        "Regularly nice cackle ourselves heavily now."
      ],
      "width": 0,
      "default_hidden": false,
      "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
   }
 ],
 "id_default_hidden": false,
 "updated_default_hidden": false,
}

The Database Table List Object

Database Table List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Database Table objects

Methods That Use This Object

Get Databases	View Method

Example Object

{
 "object": "list",
 "total_count": 1,
 "start_item": 51,
 "end_item": 38,
 "has_more": false,
 "next_page_token": 75,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 57,
    "object": "databasetable",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 10,
    "user_id": 90,
    "name": "",
    "short_desc": "",
    "desc": "",
    "desc_type": "",
    "edit_table": "database_access_all",
    "edit_rows": "database_access_all",
    "add_rows": "database_access_all",
    "view_table": "database_access_all",
    "num_rows": 22,
    "max_row_id": 75,
    "num_columns": 2,
    "max_col_id": 12,
    "display_template": "",
    "columns": [
      {
         "id": 52691321,
         "name": "Multiple Choice: Including tribe anything from whose.",
         "type": "multiple_choice_column",
         "required": true,
         "color": "color_orchid",
         "choices": [
           "Next each secondly must catch politely.",
           "Sleepy where i.e. inquisitively yours wisp.",
           "Regularly nice cackle ourselves heavily now."
         ],
         "width": 0,
         "default_hidden": false,
         "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
      }
    ],
    "id_default_hidden": false,
    "updated_default_hidden": false,
   }
 ],
}

The Database Value Object

The database value object. This defines a cell in the database.

Response Attributes

col_id number	The column ID.
col_type string	The column type. Can be one of: `address_column`, `checkbox_column`, `date_column`, `email_column`, `github_id_column`, `html_paragraph_column`, `image_column`, `link_column`, `multi_choice_column`, `multiple_choice_column`, `number_column`, `paragraph_column`, `text_column`, `time_column`.
text optional string	For columns of type `text`.
html_text optional string	For columns of type `html_paragraph`.
date optional date	For columns of type `time`.
time optional date	For columns of type `date`.
checked optional boolean	For columns of type `checkbox`.
multi_choice optional array of number	For columns of type `multi_choice` and `multiple_choice`.
street_address1 optional string	For columns of type `address`.
street_address2 optional string	For columns of type `address`.
city optional string	For columns of type `address`.
state optional string	For columns of type `address`.
zip optional string	For columns of type `address`.
country optional string	For columns of type `address`.
lat optional number	Google maps geocode latitude coordinate for `address` columns.
lng optional number	Google maps geocode longitude coordinate for `address` columns.
title optional string	For columns of type `link`.
url optional string	For columns of type `link`.
desc optional string	For columns of type `link`.
image_name optional string	For columns of type `image`.
image_data optional array of byte
number optional number	For columns of type `number`.
github_login optional string	For columns of type `github_id`.
github_name optional string
github_email optional string
github_avatar_url optional string
github_profile_url optional string
github_id optional number
github_company optional string
github_location optional string
github_bio optional string

Example Object

{
 "col_id": 89,
 "col_type": "address_column",
 "text": "",
 "html_text": "",
 "date": "2009-11-10T15:00:00-08:00",
 "time": "2009-11-10T15:00:00-08:00",
 "checked": false,
 "multi_choice": [98],
 "street_address1": "",
 "street_address2": "",
 "city": "",
 "state": "",
 "zip": "",
 "country": "",
 "lat": "",
 "lng": "",
 "title": "",
 "url": "",
 "desc": "",
 "image_name": "",
 "image_data": [""],
 "number": "",
 "github_login": "",
 "github_name": "",
 "github_email": "",
 "github_avatar_url": "",
 "github_profile_url": "",
 "github_id": 19,
 "github_company": "",
 "github_location": "",
 "github_bio": "",
}

The Delivery Info Object

The delivery info object.

Response Attributes

object string	delivery_info.
created date
updated date
group_id number	ID of the group.
success_msg_id number	most recent successful delivery.
success_time date
success_subject string
success_type string	Can be one of: `delivery_bounce_probe`, `delivery_confirmation`, `delivery_digest`, `delivery_direct_add`, `delivery_invite`, `delivery_login_link`, `delivery_member_notice`, `delivery_mod_notice`, `delivery_reply`, `delivery_reverify`, `delivery_single`, `delivery_summary`, `delivery_to_owner`, `delivery_to_sub`.
success_response string
attempt_msg_id number	most recent attempted delivery.
attempt_time date
attempt_subject string
attempt_type string	Can be one of: `delivery_bounce_probe`, `delivery_confirmation`, `delivery_digest`, `delivery_direct_add`, `delivery_invite`, `delivery_login_link`, `delivery_member_notice`, `delivery_mod_notice`, `delivery_reply`, `delivery_reverify`, `delivery_single`, `delivery_summary`, `delivery_to_owner`, `delivery_to_sub`.
attempt_response string
bounces array of Bounce Info objects	Bounces.

Methods That Use This Object

Get Delivery Info	View Method

Example Object

{
 "object": "delivery_info",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 75,
 "success_msg_id": 42,
 "success_time": "2009-11-10T15:00:00-08:00",
 "success_subject": "",
 "success_type": "delivery_bounce_probe",
 "success_response": "",
 "attempt_msg_id": 86,
 "attempt_time": "2009-11-10T15:00:00-08:00",
 "attempt_subject": "",
 "attempt_type": "delivery_bounce_probe",
 "attempt_response": "",
 "bounces": [
   {
    "object": "bounce_info",
    "created": "2009-11-10T15:00:00-08:00",
    "group_id": 84,
    "msg_id": 4,
    "subject": "",
    "response": "",
    "is_hard": false,
    "type": "delivery_bounce_probe",
   }
 ],
}

The Direct Add Error Object

The direct add error object.

Response Attributes

object string	direct_add_error.
email string
alias_of string
status string	utils.DirectAddStatus.
group_id number

Example Object

{
 "object": "direct_add_error",
 "email": "",
 "alias_of": "",
 "status": "",
 "group_id": 12,
}

The Direct Add Results Object

The direct add results object.

Response Attributes

object string	direct_add_results.
total_emails number
errors array of Direct Add Error objects
added_members array of Member Info objects

Methods That Use This Object

Direct Add	View Method
Send Invites	View Method

Example Object

{
 "object": "direct_add_results",
 "total_emails": 88,
 "errors": [
   {
    "object": "direct_add_error",
    "email": "",
    "alias_of": "",
    "status": "",
    "group_id": 55,
   }
 ],
 "added_members": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

The Draft Object

The draft object. Draft represents a draft of a posting (a post in process of being written).

Response Attributes

id number	Unique ID of the draft object.
object string	draft.
created date
updated date
user_id number	ID of the user who created the draft.
group_id number	ID of the group the draft was created in.
draft_type string	The type of message this draft represents.
subject string	Subject of the draft message.
body string	Body of the draft message.
body_type string	Body type of the draft message.
is_special boolean	If the draft should be sent as a special message. Only applicable for `draft_type_post` and `draft_type_reply`.
num_attachments number	The number of attachments associated with the draft.
next_attachment_id number	The ID of the next attachment to be uploaded.
message_id number	message_id is for replies, and is the ID of the Message we're replying to.
bcc_me boolean	If we should BCC ourselves with the message. Only applicable for `draft_type_post_to_sub`.
bcc_all boolean	If we should BCC all moderators with the message. Only applicable for `draft_type_post_to_sub`.

Methods That Use This Object

New Draft	View Method
Update Draft	View Method

Example Object

{
 "id": 69,
 "object": "draft",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 9,
 "group_id": 92,
 "draft_type": "",
 "subject": "",
 "body": "",
 "body_type": "",
 "is_special": false,
 "num_attachments": 28,
 "next_attachment_id": 89,
 "message_id": 39,
 "bcc_me": false,
 "bcc_all": false,
}

The Draft Attachment Object

The draft attachment object. This represents an attachment associated with a draft.

Response Attributes

id number	ID of the draft attachment object.
object string	draft_attachment.
draft_id number	ID of the draft this attachment is associated with.
url string	The URL of the draft attachment, for displaying the attachment.
filename string	Filename of the attachment.
size number	Size of the attachment.
content_type string	Content type of the attachment.
inline boolean	If the attachment represents an inline image.

Example Object

{
 "id": 37,
 "object": "draft_attachment",
 "draft_id": 58,
 "url": "",
 "filename": "",
 "size": 59,
 "content_type": "",
 "inline": false,
}

The Draft Attachment List Object

Draft Attachment List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Draft Attachment objects

Methods That Use This Object

Upload Attachments	View Method
Get Attachments	View Method

Example Object

{
 "object": "list",
 "total_count": 35,
 "start_item": 63,
 "end_item": 7,
 "has_more": false,
 "next_page_token": 20,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 3,
    "object": "draft_attachment",
    "draft_id": 88,
    "url": "",
    "filename": "",
    "size": 36,
    "content_type": "",
    "inline": false,
   }
 ],
}

The Draft List Object

Draft List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Draft objects

Methods That Use This Object

Get Drafts	View Method

Example Object

{
 "object": "list",
 "total_count": 54,
 "start_item": 99,
 "end_item": 19,
 "has_more": false,
 "next_page_token": 34,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 16,
    "object": "draft",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 0,
    "group_id": 11,
    "draft_type": "",
    "subject": "",
    "body": "",
    "body_type": "",
    "is_special": false,
    "num_attachments": 23,
    "next_attachment_id": 56,
    "message_id": 89,
    "bcc_me": false,
    "bcc_all": false,
   }
 ],
}

The Enterprise Info Object

The enterprise object.

Response Attributes

object string	enterprise_info.
domain string
logo array of byte

Example Object

{
 "object": "enterprise_info",
 "domain": "",
 "logo": [""],
}

The Error Object

The error object.

Response Attributes

object string	error.
type string
extra string

Example Object

{
 "object": "error",
 "type": "",
 "extra": "",
}

The Event Object

The event object.

Response Attributes

id number	Unique ID of the rsvp object.
object string	event.
created date	The time that this object was created.
updated date	The time that this object was last updated.
creator_name string	Name of the person who created this event.
group_id number	The ID of the associated group.
group_name string	Name of the associated group.
nice_group_name string	Nice version of the group name.
start_time date	Start time of event.
end_time date	End time of event.
timezone string	Timezone that event was created in.
all_day boolean	If event is all day.
name string	Name of the event.
location string	Location of the event.
description string	Event description, in HTML format.
organizer_name string	Organizer name.
organizer_email string	Organizer email.
organizer_phone string	Organizer phone number.
color_name string	Name of the event color. Can be one of: `color_antique_pink`, `color_apricot`, `color_aquamute`, `color_beige`, `color_bluejean`, `color_blush`, `color_burnt_yellow`, `color_capri_blue`, `color_cerulean_blue`, `color_cherry_blossom`, `color_cloudy_blue`, `color_cucumber`, `color_dark_grey`, `color_dark_orange`, `color_dusty_mauve`, `color_emerald_green`, `color_grape`, `color_green_lantern`, `color_green_sage`, `color_grey_blue`, `color_light_brown`, `color_light_grey`, `color_light_lilac`, `color_lilac`, `color_lips`, `color_melon`, `color_military`, `color_moss_green`, `color_mulbery`, `color_mustard`, `color_none`, `color_orange`, `color_orchid`, `color_peony`, `color_pink`, `color_purple`, `color_purple_blue`, `color_purple_grey`, `color_sage`, `color_sky`, `color_terracotta`, `color_tomato`, `color_yellow`.
color_hex string	Hex value of the event color.
rsvp boolean	Requesting an RSVP.
max_attendees number	Number of attendees for RSVP events (0 if unlimited).
additional_guests boolean	Whether attendees can bring additional people.
comment_label string	If additional information is requested, this is the label for that field.
yes_message string	Email to send when people RSVP Yes, in same format as Format.
has_rsvp boolean	If there is an RSVP record for this event corresponding to this user.
rsvp_type string	Type of RSVP.
rsvp_comment string	Any comment left with the RSVP.
rsvp_additional_guests number	Number of additional guests specified by the RSVP.

Methods That Use This Object

Get Event	View Method
Add Event	View Method
Add Repeat Event	View Method
Split Repeat Event	View Method

Example Object

{
 "id": 70,
 "object": "event",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "creator_name": "@JohnSmith",
 "group_id": 54,
 "group_name": "",
 "nice_group_name": "",
 "start_time": "2009-11-10T15:00:00-08:00",
 "end_time": "2009-11-10T15:00:00-08:00",
 "timezone": "",
 "all_day": false,
 "name": "",
 "location": "",
 "description": "",
 "organizer_name": "",
 "organizer_email": "",
 "organizer_phone": "",
 "color_name": "color_antique_pink",
 "color_hex": "",
 "rsvp": false,
 "max_attendees": 11,
 "additional_guests": false,
 "comment_label": "",
 "yes_message": "",
 "has_rsvp": false,
 "rsvp_type": "",
 "rsvp_comment": "",
 "rsvp_additional_guests": 15,
}

The Event List Object

The Event List object contains a list of Event objects.

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Event objects

Methods That Use This Object

Get Events	View Method

Example Object

{
 "object": "list",
 "total_count": 51,
 "start_item": 88,
 "end_item": 58,
 "has_more": false,
 "next_page_token": 13,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 49,
    "object": "event",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "creator_name": "@JohnSmith",
    "group_id": 49,
    "group_name": "",
    "nice_group_name": "",
    "start_time": "2009-11-10T15:00:00-08:00",
    "end_time": "2009-11-10T15:00:00-08:00",
    "timezone": "",
    "all_day": false,
    "name": "",
    "location": "",
    "description": "",
    "organizer_name": "",
    "organizer_email": "",
    "organizer_phone": "",
    "color_name": "color_antique_pink",
    "color_hex": "",
    "rsvp": false,
    "max_attendees": 31,
    "additional_guests": false,
    "comment_label": "",
    "yes_message": "",
    "has_rsvp": false,
    "rsvp_type": "",
    "rsvp_comment": "",
    "rsvp_additional_guests": 22,
   }
 ],
}

The Feed Object

The Feed object contains all the data required for displaying one group in a user's feed page.

Response Attributes

object string	feed.
member_info Member Info object
group Group object
topics optional array of Feed Topic objects	The five most recent topics.
events optional array of Event objects	The next four upcoming events.
files optional array of File objects	The five most recent file uploads.
photos optional array of Photo objects	The nine most recent photo uploads.
chats optional array of Chat objects	The five most recent chats.
wikis optional array of Wiki Page objects	The five most recently updated wiki pages.
subgroups optional array of Group objects	The five newest subgroups, if this is a parent group.
tables optional array of Database Table objects	The five most recently updated database tables.
hashtags optional array of Hashtag objects	The ten most popular hashtags.

Methods That Use This Object

Get Single Feed	View Method

Example Object

{
 "object": "feed",
 "member_info": 
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   },
 "group": 
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   },
 "topics": [
   {
    "topic": 
      {
         "id": 52691321,
         "object": "topic",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "group_id": 8658933,
         "group_subject_tag": "[StrategyHub]",
         "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
         "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
         "name": "Elenor Schaefer",
         "profile_photo_url": "",
         "num_messages": 22,
         "is_sticky": false,
         "is_moderated": false,
         "is_closed": false,
         "has_attachments": false,
         "reply_to": "thread_reply_group_default",
         "most_recent_message": "2020-09-29T17:03:00-07:00",
         "hashtags": null
      },
    "images": [
      {
       "id": "",
       "object": "attachment",
       "created": "2009-11-10T15:00:00-08:00",
       "group_id": 42,
       "user_id": 50,
       "thread_id": 68,
       "message_num": 30,
       "attach_num": 37,
       "type": "",
       "sub_type": "",
       "name": "",
       "content": "",
       "image_width": 96,
       "image_height": 47,
       "thumbnail_url": "",
      }
    ],
   }
 ],
 "events": [
   {
    "id": 75,
    "object": "event",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "creator_name": "@JohnSmith",
    "group_id": 11,
    "group_name": "",
    "nice_group_name": "",
    "start_time": "2009-11-10T15:00:00-08:00",
    "end_time": "2009-11-10T15:00:00-08:00",
    "timezone": "",
    "all_day": false,
    "name": "",
    "location": "",
    "description": "",
    "organizer_name": "",
    "organizer_email": "",
    "organizer_phone": "",
    "color_name": "color_antique_pink",
    "color_hex": "",
    "rsvp": false,
    "max_attendees": 41,
    "additional_guests": false,
    "comment_label": "",
    "yes_message": "",
    "has_rsvp": false,
    "rsvp_type": "",
    "rsvp_comment": "",
    "rsvp_additional_guests": 1,
   }
 ],
 "files": [
   {
      "id": 52691321,
      "object": "file",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "name": "Kelsi Ledner",
      "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
      "size": 132787700,
      "path": "topfolder/subfolder",
      "parent_folder_id": 0,
      "type": "file_type_file",
      "count": 2,
      "media_type": "text/plain",
      "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
      "display_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "email": "gersonbeahan@..."
   }
 ],
 "photos": [
   {
      "id": 960,
      "object": "photo",
      "created": "2020-09-06T23:48:00-07:00",
      "updated": "2022-03-08T08:06:00-08:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "name": "Elegance joy group",
      "desc": "Senegalese whichever happen trade move outside downstairs of exemplified up. Out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for. Her our much nevertheless which numerous alone bevy as by. From e.g. otherwise laptop cloud then them yourselves few look.",
      "media_type": "image/jpg",
      "size": 2390440,
      "attachment_num": 0,
      "width": 0,
      "height": 0,
      "album_id": 52691321,
      "display_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "profile_privacy": "profile_private",
      "email": "gersonbeahan@...",
      "format": "jpeg",
      "focal_length": 0,
      "iso": 0,
      "aperture": 0,
      "shutter_speed": 0,
      "taken": 0,
      "make": "",
      "model": ""
   }
 ],
 "chats": [
   {
      "id": 52691321,
      "object": "chat",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "user_id": 147779411,
      "profile_photo_url": "",
      "name": "",
      "can_view_profile": false,
      "group_id": 8658933,
      "subject": "Including.",
      "desc": "Tribe anything from.",
      "is_closed": false,
      "num_messages": 21,
      "chat_sub": {
        "id": 179889653,
        "object": "chat_sub",
        "created": "2020-09-10T11:42:00-07:00",
        "updated": "2023-03-29T23:48:00-07:00",
        "user_id": 147779411,
        "group_id": 8658933,
        "chat_id": 52691321,
        "last_msg_seen": 40
      }
   }
 ],
 "wikis": [
   {
      "id": 52691321,
      "object": "wiki_page",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "title": "Including tribe anything from whose market",
      "path": "Including-tribe-anything-from-whose-market",
      "locked": false,
      "rev_count": 43
   }
 ],
 "subgroups": [
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   }
 ],
 "tables": [
   {
    "id": 54,
    "object": "databasetable",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 87,
    "user_id": 30,
    "name": "",
    "short_desc": "",
    "desc": "",
    "desc_type": "",
    "edit_table": "database_access_all",
    "edit_rows": "database_access_all",
    "add_rows": "database_access_all",
    "view_table": "database_access_all",
    "num_rows": 19,
    "max_row_id": 35,
    "num_columns": 53,
    "max_col_id": 48,
    "display_template": "",
    "columns": [
      {
         "id": 52691321,
         "name": "Multiple Choice: Including tribe anything from whose.",
         "type": "multiple_choice_column",
         "required": true,
         "color": "color_orchid",
         "choices": [
           "Next each secondly must catch politely.",
           "Sleepy where i.e. inquisitively yours wisp.",
           "Regularly nice cackle ourselves heavily now."
         ],
         "width": 0,
         "default_hidden": false,
         "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
      }
    ],
    "id_default_hidden": false,
    "updated_default_hidden": false,
   }
 ],
 "hashtags": [
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   }
 ],
}

The Feed List Object

The Feed List object contains a list of Feed objects.

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Feed objects

Methods That Use This Object

Get Feed	View Method

Example Object

{
 "object": "list",
 "total_count": 30,
 "start_item": 86,
 "end_item": 16,
 "has_more": false,
 "next_page_token": 42,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "object": "feed",
    "member_info": 
      {
         "id": 93846546,
         "object": "member_info",
         "created": "2020-09-09T04:11:00-07:00",
         "updated": "2022-06-08T07:16:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "group_name": "StrategyHub",
         "status": "sub_status_normal",
         "post_status": "sub_poststatus_newusermoderated",
         "email_delivery": "email_delivery_digest",
         "message_selection": "message_selection_follow_and_first_message",
         "auto_follow_replies": false,
         "max_attachment_size": "max_attachment_size_medium",
         "approved_posts": 0,
         "mod_status": "sub_modstatus_owner",
         "pending_msg_notify": "sub_notify_email_and_app",
         "pending_sub_notify": "sub_notify_email_and_app",
         "sub_notify": "sub_notify_email_and_app",
         "storage_notify": "sub_notify_email_and_app",
         "sub_group_notify": "sub_notify_email_and_app",
         "message_report_notify": "sub_notify_email_and_app",
         "account_notify": "sub_notify_email_and_app",
         "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
         "owner_msg_notify": "sub_ownermsg_notify_subs",
         "chat_notify": "sub_notify_email_and_app",
         "photo_notify": "sub_notify_email_and_app",
         "file_notify": "sub_notify_email_and_app",
         "wiki_notify": "sub_notify_email_and_app",
         "database_notify": "sub_notify_email_and_app",
         "email": "gersonbeahan@jacobi.io",
         "user_status": "user_status_confirmed",
         "user_name": "Dickens6041",
         "timezone": "America/Chicago",
         "full_name": "Lawson Kreiger",
         "about_me": "Today awfully arrive at",
         "location": "Well away onto",
         "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "profile_privacy": "profile_private",
         "dont_munge_message_id": false,
         "use_signature": false,
         "use_signature_email": false,
         "signature": "In hotel furniture anyone weakly besides",
         "color": "color_cerulean_blue",
         "cover_photo_url": "",
         "icon_url": "",
         "nice_group_name": "",
         "subs_count": 0,
         "most_recent_message": "0001-01-01T00:00:00Z",
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "member_labels": [
           {
             "id": 726,
             "object": "memberlabel",
             "created": "2020-09-29T22:19:00Z",
             "group_id": 1857,
             "name": "Florida",
             "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
             "color_name": "green-sage",
             "color_hex": "#9fc4ac"
           },
           {
             "id": 1594,
             "object": "memberlabel",
             "created": "2020-09-24T02:24:00Z",
             "group_id": 42,
             "name": "Russel",
             "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
             "color_name": "purple",
             "color_hex": "#837fd5"
           },
           {
             "id": 1189,
             "object": "memberlabel",
             "created": "2020-09-12T02:11:00Z",
             "group_id": 1474,
             "name": "Meta",
             "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
             "color_name": "sky",
             "color_hex": "#9cc7df"
           }
         ],
         "extra_member_data": [
           {
             "col_id": 48876437,
             "col_type": "text_column",
             "text": "To firstly unlock while host himself me purely as whose."
           },
           {
             "col_id": 161476183,
             "col_type": "paragraph_column",
             "text": "Yet few mustering example will addition yearly since in these."
           },
           {
             "col_id": 39354277,
             "col_type": "checkbox_column",
             "checked": false
           },
           {
             "col_id": 8897324,
             "col_type": "multiple_choice_column",
             "multi_choice": [
               0
             ]
           },
           {
             "col_id": 159828550,
             "col_type": "date_column",
             "date": "1916-10-16T17:57:55.797000001Z"
           },
           {
             "col_id": 185149472,
             "col_type": "time_column",
             "time": "1919-03-30T18:00:36.790929649Z"
           },
           {
             "col_id": 166814414,
             "col_type": "address_column",
             "street_address1": "Premier Medical Group",
             "street_address2": "3701 DAUPHIN ST",
             "city": "MOBILE",
             "state": "AL",
             "zip": "36608-1756",
             "lat": 30.6866076,
             "lng": -88.13019249999999
           },
           {
             "col_id": 102385421,
             "col_type": "multi_choice_column",
             "multi_choice": [
               0,
               1,
               2
             ]
           },
           {
             "col_id": 154317202,
             "col_type": "link_column",
             "title": "To say poorly out according abundant unless nervously string lastly.",
             "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
             "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
           },
           {
             "col_id": 123191768,
             "col_type": "image_column",
             "url": "https://picsum.photos/id/27/187/110",
             "image_name": "Lately blazer with wild hourly there she it infrequently power."
           },
           {
             "col_id": 53386358,
             "col_type": "html_paragraph_column",
             "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
           },
           {
             "col_id": 45812071,
             "col_type": "email_column",
             "text": "brantkozey@bernhard.com"
           }
         ]
      },
    "group": 
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      },
    "topics": [
      {
       "topic": 
         {
            "id": 52691321,
            "object": "topic",
            "created": "2020-09-15T02:30:00-07:00",
            "updated": "2021-03-01T18:07:00-08:00",
            "group_id": 8658933,
            "group_subject_tag": "[StrategyHub]",
            "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
            "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
            "name": "Elenor Schaefer",
            "profile_photo_url": "",
            "num_messages": 22,
            "is_sticky": false,
            "is_moderated": false,
            "is_closed": false,
            "has_attachments": false,
            "reply_to": "thread_reply_group_default",
            "most_recent_message": "2020-09-29T17:03:00-07:00",
            "hashtags": null
         },
       "images": [
         {
          "id": "",
          "object": "attachment",
          "created": "2009-11-10T15:00:00-08:00",
          "group_id": 36,
          "user_id": 61,
          "thread_id": 41,
          "message_num": 78,
          "attach_num": 96,
          "type": "",
          "sub_type": "",
          "name": "",
          "content": "",
          "image_width": 17,
          "image_height": 81,
          "thumbnail_url": "",
         }
       ],
      }
    ],
    "events": [
      {
       "id": 64,
       "object": "event",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "creator_name": "@JohnSmith",
       "group_id": 8,
       "group_name": "",
       "nice_group_name": "",
       "start_time": "2009-11-10T15:00:00-08:00",
       "end_time": "2009-11-10T15:00:00-08:00",
       "timezone": "",
       "all_day": false,
       "name": "",
       "location": "",
       "description": "",
       "organizer_name": "",
       "organizer_email": "",
       "organizer_phone": "",
       "color_name": "color_antique_pink",
       "color_hex": "",
       "rsvp": false,
       "max_attendees": 57,
       "additional_guests": false,
       "comment_label": "",
       "yes_message": "",
       "has_rsvp": false,
       "rsvp_type": "",
       "rsvp_comment": "",
       "rsvp_additional_guests": 53,
      }
    ],
    "files": [
      {
         "id": 52691321,
         "object": "file",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "name": "Kelsi Ledner",
         "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
         "size": 132787700,
         "path": "topfolder/subfolder",
         "parent_folder_id": 0,
         "type": "file_type_file",
         "count": 2,
         "media_type": "text/plain",
         "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
         "display_name": "Lawson Kreiger",
         "user_name": "Dickens6041",
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "profile_privacy": "profile_private",
         "email": "gersonbeahan@..."
      }
    ],
    "photos": [
      {
         "id": 960,
         "object": "photo",
         "created": "2020-09-06T23:48:00-07:00",
         "updated": "2022-03-08T08:06:00-08:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "name": "Elegance joy group",
         "desc": "Senegalese whichever happen trade move outside downstairs of exemplified up. Out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for. Her our much nevertheless which numerous alone bevy as by. From e.g. otherwise laptop cloud then them yourselves few look.",
         "media_type": "image/jpg",
         "size": 2390440,
         "attachment_num": 0,
         "width": 0,
         "height": 0,
         "album_id": 52691321,
         "display_name": "Lawson Kreiger",
         "user_name": "Dickens6041",
         "profile_privacy": "profile_private",
         "email": "gersonbeahan@...",
         "format": "jpeg",
         "focal_length": 0,
         "iso": 0,
         "aperture": 0,
         "shutter_speed": 0,
         "taken": 0,
         "make": "",
         "model": ""
      }
    ],
    "chats": [
      {
         "id": 52691321,
         "object": "chat",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "user_id": 147779411,
         "profile_photo_url": "",
         "name": "",
         "can_view_profile": false,
         "group_id": 8658933,
         "subject": "Including.",
         "desc": "Tribe anything from.",
         "is_closed": false,
         "num_messages": 21,
         "chat_sub": {
           "id": 179889653,
           "object": "chat_sub",
           "created": "2020-09-10T11:42:00-07:00",
           "updated": "2023-03-29T23:48:00-07:00",
           "user_id": 147779411,
           "group_id": 8658933,
           "chat_id": 52691321,
           "last_msg_seen": 40
         }
      }
    ],
    "wikis": [
      {
         "id": 52691321,
         "object": "wiki_page",
         "created": "2020-09-15T02:30:00-07:00",
         "updated": "2021-03-01T18:07:00-08:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "title": "Including tribe anything from whose market",
         "path": "Including-tribe-anything-from-whose-market",
         "locked": false,
         "rev_count": 43
      }
    ],
    "subgroups": [
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      }
    ],
    "tables": [
      {
       "id": 38,
       "object": "databasetable",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "group_id": 70,
       "user_id": 52,
       "name": "",
       "short_desc": "",
       "desc": "",
       "desc_type": "",
       "edit_table": "database_access_all",
       "edit_rows": "database_access_all",
       "add_rows": "database_access_all",
       "view_table": "database_access_all",
       "num_rows": 37,
       "max_row_id": 40,
       "num_columns": 48,
       "max_col_id": 39,
       "display_template": "",
       "columns": [
         {
            "id": 52691321,
            "name": "Multiple Choice: Including tribe anything from whose.",
            "type": "multiple_choice_column",
            "required": true,
            "color": "color_orchid",
            "choices": [
              "Next each secondly must catch politely.",
              "Sleepy where i.e. inquisitively yours wisp.",
              "Regularly nice cackle ourselves heavily now."
            ],
            "width": 0,
            "default_hidden": false,
            "description": "Market pyramid accordingly onto moreover whenever e.g. fear usually body."
         }
       ],
       "id_default_hidden": false,
       "updated_default_hidden": false,
      }
    ],
    "hashtags": [
      {
         "id": 541,
         "object": "hashtag",
         "created": "2020-09-17T11:22:00-07:00",
         "group_id": 1188,
         "name": "Karl",
         "mods_only_post": false,
         "mods_only_replies": false,
         "no_email": false,
         "moderated": false,
         "special": true,
         "replies_unmoderated": false,
         "locked": true,
         "until": "hashtag_delete_month",
         "close_instead_of_delete": true,
         "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
         "color_name": "pink",
         "color_hex": "#f39de4",
         "reply_to": "thread_reply_to_sender",
         "topic_count": 1789,
         "last_message_date": "2020-09-08T01:22:00-07:00",
         "muted": null,
         "followed": null
      }
    ],
   }
 ],
}

The Feed Topic Object

The Feed Topic object combines a Topic object and an array of Images that go with the most recent message in that topic.

Response Attributes

topic Topic object
images optional array of Attachment objects

Example Object

{
 "topic": 
   {
      "id": 52691321,
      "object": "topic",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "group_id": 8658933,
      "group_subject_tag": "[StrategyHub]",
      "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
      "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
      "name": "Elenor Schaefer",
      "profile_photo_url": "",
      "num_messages": 22,
      "is_sticky": false,
      "is_moderated": false,
      "is_closed": false,
      "has_attachments": false,
      "reply_to": "thread_reply_group_default",
      "most_recent_message": "2020-09-29T17:03:00-07:00",
      "hashtags": null
   },
 "images": [
   {
    "id": "",
    "object": "attachment",
    "created": "2009-11-10T15:00:00-08:00",
    "group_id": 81,
    "user_id": 28,
    "thread_id": 76,
    "message_num": 73,
    "attach_num": 89,
    "type": "",
    "sub_type": "",
    "name": "",
    "content": "",
    "image_width": 69,
    "image_height": 65,
    "thumbnail_url": "",
   }
 ],
}

The File Object

The file object.

Response Attributes

id number
object string	file.
created date
updated date
user_id number
group_id number
name string
desc string
size number
path string	The path to get to this file or folder.
parent_folder_id number	If this is a sub folder, this is the ID of the parent folder.
type string	Type of object this record represents.
count number	If this is a directory, how many items are within it.
media_type optional string	If this is a file, the media type.
download_url optional string
display_name optional string
user_name optional string
profile_photo_url optional string
profile_privacy optional string	Privacy setting of the sender of the message.
email optional string	Possibly obscured, depending on group settings.

Methods That Use This Object

Get File	View Method

Example Object

{
   "id": 52691321,
   "object": "file",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "name": "Kelsi Ledner",
   "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
   "size": 132787700,
   "path": "topfolder/subfolder",
   "parent_folder_id": 0,
   "type": "file_type_file",
   "count": 2,
   "media_type": "text/plain",
   "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@..."
}

The File List Object

File List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
path string	Path to this directory level.
files_percentage number	Percentage of total storage used by the Files section.
files_gigs string	Number of GB used by the Files section.
data array of File objects

Methods That Use This Object

Add Files	View Method
Add Link	View Method
Get File Directory	View Method
Search Files	View Method
Delete File	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "path": "",
   "files_percentage": 0,
   "files_gigs": "",
   "data": [
     {
       "id": 52691321,
       "object": "file",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Kelsi Ledner",
       "desc": "Tribe anything from whose market pyramid accordingly onto moreover whenever.",
       "size": 132787700,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/52691321/Kelsi%20Ledner?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=f9OgZqyaAB%2B3EHhaNVaJ65U4kWY%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 189377967,
       "object": "file",
       "created": "2020-09-29T17:03:00-07:00",
       "updated": "2022-06-18T23:30:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Lilly Block",
       "desc": "Few why where win most would everybody them backwards this.",
       "size": 98233877,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/189377967/Lilly%20Block?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=H6FoD1Eh%2Br72mXAY6EY9fWWoBao%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     },
     {
       "id": 175712125,
       "object": "file",
       "created": "2020-09-08T01:22:00-07:00",
       "updated": "2022-04-15T08:51:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Ludwig Douglas",
       "desc": "Mine year is ever what flock jealousy inside pod without.",
       "size": 197424827,
       "path": "topfolder/subfolder",
       "parent_folder_id": 0,
       "type": "file_type_file",
       "count": 2,
       "media_type": "text/plain",
       "download_url": "https://s3-us-west-1.amazonaws.com/8658933/175712125/Ludwig%20Douglas?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=J3IWI%2BNmeX3lNuAmgl9xAdDYs7k%3D",
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@..."
     }
   ]
}

The Group Object

The group object.

Response Attributes

id number	Unique ID of the group object.
object string	group.
created date
updated date
type string	Type of group.
title string	Group title.
name string	Group name.
nice_group_name string	Nice version of the group name.
alias string	Alias.
desc string	Group description, in HTML.
plain_desc string	Plain text version of the description.
subject_tag string	Prepended to subject lines.
footer string	Appended to group messages.
website string	URL of associated website.
announce boolean
moderation string	Can be one of: `moderate_first_message`, `moderated`, `no_moderation`.
new_users_moderated boolean
unmoderate_users_after number	Unmoderate users after N consecutive approved posts.
restricted boolean
invite_only boolean	If the group is invite-only.
allow_non_subs_to_post boolean
force_html_emails boolean
normalize_html_emails boolean	strip all font/colors/bg stuff from messages.
reply_to string	Can be one of: `group_reply_only_to_sender`, `group_reply_to_followers_only`, `group_reply_to_group`, `group_reply_to_group_and_sender`, `group_reply_to_group_id`, `group_reply_to_moderators`, `group_reply_to_sender`.
remove_other_reply_options boolean
privacy string	Can be one of: `group_privacy_archives`, `group_privacy_none`, `group_privacy_unlisted`, `group_privacy_unlisted_public`, `sub_group_privacy_unlisted_public_archives`.
seperate_footers boolean	Place message footers in separate mime part.
allow_downloads string	If we let members download archives. Can be one of: `allow_downloads_by_members`, `allow_downloads_no`.
members_visible string	Can be one of: `group_view_members_moderators`, `group_view_members_owners`, `group_view_members_subs`.
sub_group_access string	Who can create subgroups. Can be one of: `sub_group_moderators`, `sub_group_owners`, `sub_group_subs`.
calendar_access string	Access control for the calendar. Can be one of: `group_access_limited`, `group_access_moderators_only`, `group_access_mods_folders_only`, `group_access_none`, `group_access_parent`, `group_access_parent_limited`, `group_access_public`, `group_access_public_limited`, `group_access_subscribers`.
files_access string	Access control for the files section. Can be one of: `group_access_limited`, `group_access_moderators_only`, `group_access_mods_folders_only`, `group_access_none`, `group_access_parent`, `group_access_parent_limited`, `group_access_public`, `group_access_public_limited`, `group_access_subscribers`.
database_access string	Access control for the database section. Can be one of: `group_access_limited`, `group_access_moderators_only`, `group_access_mods_folders_only`, `group_access_none`, `group_access_parent`, `group_access_parent_limited`, `group_access_public`, `group_access_public_limited`, `group_access_subscribers`.
wiki_access string	Access control for the wiki section. Can be one of: `group_access_limited`, `group_access_moderators_only`, `group_access_mods_folders_only`, `group_access_none`, `group_access_parent`, `group_access_parent_limited`, `group_access_public`, `group_access_public_limited`, `group_access_subscribers`.
photos_access string	Access control for the photo section. Can be one of: `group_access_limited`, `group_access_moderators_only`, `group_access_mods_folders_only`, `group_access_none`, `group_access_parent`, `group_access_parent_limited`, `group_access_public`, `group_access_public_limited`, `group_access_subscribers`.
member_directory_access string	Access control for the member directory section. Can be one of: `group_access_limited`, `group_access_moderators_only`, `group_access_mods_folders_only`, `group_access_none`, `group_access_parent`, `group_access_parent_limited`, `group_access_public`, `group_access_public_limited`, `group_access_subscribers`.
polls_access string	Access control for the polls section. Can be one of: `polls_access_limited`, `polls_access_none`, `polls_access_subscribers`.
chat_access string	Access control for the chat section. Can be one of: `group_access_limited`, `group_access_moderators_only`, `group_access_mods_folders_only`, `group_access_none`, `group_access_parent`, `group_access_parent_limited`, `group_access_public`, `group_access_public_limited`, `group_access_subscribers`.
handle_attachments string	Can be one of: `group_attachments_bounced`, `group_attachments_moderated`, `group_attachments_normal`, `group_attachments_stripped`.
plain_text_only boolean
handle_virus string	How we handle messages that may have viruses. Can be one of: `handle_virus_block`, `handle_virus_moderate`.
locked boolean	If the group is locked.
plan string	What plan is group is set to. Can be one of: `group_plan_basic`, `group_plan_enterprise`, `group_plan_premium`.
trial_group boolean	If the group is a free-trial group.
has_cover_photo boolean
has_icon boolean
parent_group_id number
org_id number
max_photo_size_email string	If we resize photos in emails. Can be one of: `max_photo_size_ex_small`, `max_photo_size_large`, `max_photo_size_medium`, `max_photo_size_medium_small`, `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_somewhat_small`.
max_photo_size_photos string	If we resize photos uploaded to the photos section. Can be one of: `max_photo_size_ex_small`, `max_photo_size_large`, `max_photo_size_medium`, `max_photo_size_medium_small`, `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_somewhat_small`.
max_photo_size_databases string	If we resize photos uploaded to database tables. Can be one of: `max_photo_size_ex_small`, `max_photo_size_large`, `max_photo_size_medium`, `max_photo_size_medium_small`, `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_somewhat_small`.
max_photo_size_wiki_images string	If we resize photos uploaded to the wiki. Can be one of: `max_photo_size_ex_small`, `max_photo_size_large`, `max_photo_size_medium`, `max_photo_size_medium_small`, `max_photo_size_none`, `max_photo_size_small`, `max_photo_size_somewhat_small`.
hash_tags_required boolean	whether messages must be tagged or not.
hash_tag_permissions string	Can be one of: `hash_tag_create_mods_bounce`, `hash_tag_create_mods_remove`, `hash_tag_create_subs`.
bounce_attachments boolean	If out of space, bounce messages with attachments instead of deleting old attachments.
allow_photos_in_files boolean	Whether to allow photos in the Files section.
allow_reposts boolean	If true, members can repost messages. Only used with premium and enterprise groups.
min_days_between_reposts number	The minimum number of days between reposts.
max_number_of_reposts number	The maximum number of times a member can repost their message.
email_delivery_default string	Default options for new subscriptions. Can be one of: `email_delivery_digest`, `email_delivery_html_digest`, `email_delivery_none`, `email_delivery_single`, `email_delivery_special`, `email_delivery_summary`.
message_selection_default string	Can be one of: `message_selection_all`, `message_selection_follow_and_first_message`, `message_selection_follow_only`.
auto_follow_replies_default boolean
max_attachment_size_default string	Can be one of: `max_attachment_size_large`, `max_attachment_size_medium`, `max_attachment_size_none`, `max_attachment_size_small`, `max_attachment_size_unlimited`.
default_color string	Can be one of: `color_antique_pink`, `color_apricot`, `color_aquamute`, `color_beige`, `color_bluejean`, `color_blush`, `color_burnt_yellow`, `color_capri_blue`, `color_cerulean_blue`, `color_cherry_blossom`, `color_cloudy_blue`, `color_cucumber`, `color_dark_grey`, `color_dark_orange`, `color_dusty_mauve`, `color_emerald_green`, `color_grape`, `color_green_lantern`, `color_green_sage`, `color_grey_blue`, `color_light_brown`, `color_light_grey`, `color_light_lilac`, `color_lilac`, `color_lips`, `color_melon`, `color_military`, `color_moss_green`, `color_mulbery`, `color_mustard`, `color_none`, `color_orange`, `color_orchid`, `color_peony`, `color_pink`, `color_purple`, `color_purple_blue`, `color_purple_grey`, `color_sage`, `color_sky`, `color_terracotta`, `color_tomato`, `color_yellow`.
default_timezone string
default_time_pref string	Can be one of: `military_time`, `standard_time`.
default_date_pref string	Can be one of: `international_date`, `iso_date`, `us_date`.
default_monday_start boolean
disable_edits boolean	Disable ability for members to edit messages.
disable_no_email boolean	Disable ability for members to be set to No Email.
auto_close_threads boolean	Automatically lock threads after a set number of days.
close_threads_after number	unit is days.
auto_moderate_threads boolean	Automatically moderate threads after a set number of days.
moderate_threads_after number	unit is days.
sticky_wiki_page_id number	If we've set a wiki page to be displayed at the top of messages.
sub_group_categoryid number	ID of the subgroupcategory object this group belongs to, if any.
subs_count number	Number of subscribers of the group, both normal and pending.
pending_subs_count optional number	Number of pending subscribers, for restricted groups.
pending_msgs_count optional number	Number of pending messages requiring approval.
open_chats_count number	Number of open chats.
threads_count number	Number of message threads in the archives.
messages_count number	Number of messages in the archives.
org_domain string
most_recent_message date
cover_photo_url string
icon_url string
group_url string
allow_parent_subs_to_post boolean	If this is a subgroup, we can allow parent subscribers to post messages to it.
send_event_summaries boolean	Send calendar event summary emails.
event_summary_schedule string	Can be one of: `event_summary_biweekly_friday`, `event_summary_monthly`, `event_summary_weekly_friday`, `event_summary_weekly_monday`, `event_summary_weekly_saturday`, `event_summary_weekly_sunday`, `event_summary_weekly_thursday`, `event_summary_weekly_tuesday`, `event_summary_weekly_wednesday`.
send_invites_on_join boolean
perms optional Perms object	If you are subscribed to the group, these are the permissions you have.
email_address string	Email address of the group.
extra_member_data_columns optional array of Database Column objects

Methods That Use This Object

Create Group	View Method
Create Sub Group	View Method
Get Group Settings	View Method
Update Group	View Method
Add New Group Alias	View Method
Delete Group Alias	View Method

Example Object

{
   "id": 8658933,
   "object": "group",
   "created": "2020-09-15T11:29:00-07:00",
   "updated": "2022-02-12T18:51:00-08:00",
   "type": "group_type_messages",
   "title": "",
   "name": "StrategyHub",
   "nice_group_name": "",
   "alias": "",
   "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
   "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
   "subject_tag": "[StrategyHub]",
   "footer": "This is my\nFooter!!!!",
   "website": "",
   "announce": false,
   "moderation": "moderated",
   "new_users_moderated": true,
   "unmoderate_users_after": 3,
   "restricted": true,
   "invite_only": false,
   "allow_non_subs_to_post": false,
   "force_html_emails": false,
   "normalize_html_emails": false,
   "reply_to": "group_reply_to_group",
   "remove_other_reply_options": false,
   "privacy": "group_privacy_none",
   "seperate_footers": false,
   "allow_downloads": "allow_downloads_by_members",
   "members_visible": "group_view_members_moderators",
   "sub_group_access": "sub_group_subs",
   "calendar_access": "group_access_subscribers",
   "files_access": "group_access_subscribers",
   "database_access": "group_access_subscribers",
   "wiki_access": "group_access_subscribers",
   "photos_access": "group_access_subscribers",
   "member_directory_access": "group_access_subscribers",
   "polls_access": "polls_access_subscribers",
   "chat_access": "group_access_subscribers",
   "handle_attachments": "group_attachments_normal",
   "plain_text_only": false,
   "handle_virus": "handle_virus_block",
   "locked": false,
   "plan": "group_plan_premium",
   "trial_group": false,
   "has_cover_photo": false,
   "has_icon": false,
   "parent_group_id": 0,
   "org_id": 1,
   "max_photo_size_email": "max_photo_size_none",
   "max_photo_size_photos": "max_photo_size_none",
   "max_photo_size_databases": "max_photo_size_none",
   "max_photo_size_wiki_images": "max_photo_size_none",
   "hash_tags_required": false,
   "hash_tag_permissions": "hash_tag_create_subs",
   "bounce_attachments": false,
   "allow_photos_in_files": false,
   "allow_reposts": false,
   "min_days_between_reposts": 0,
   "max_number_of_reposts": 0,
   "email_delivery_default": "email_delivery_single",
   "message_selection_default": "message_selection_all",
   "auto_follow_replies_default": false,
   "max_attachment_size_default": "max_attachment_size_small",
   "default_color": "color_cerulean_blue",
   "default_timezone": "America/Los_Angeles",
   "default_time_pref": "standard_time",
   "default_date_pref": "us_date",
   "default_monday_start": false,
   "disable_edits": false,
   "disable_no_email": false,
   "auto_close_threads": false,
   "close_threads_after": 0,
   "auto_moderate_threads": false,
   "moderate_threads_after": 0,
   "sticky_wiki_page_id": 0,
   "sub_group_categoryid": 0,
   "subs_count": 541,
   "pending_subs_count": 0,
   "pending_msgs_count": 0,
   "open_chats_count": 0,
   "threads_count": 0,
   "messages_count": 0,
   "org_domain": "",
   "most_recent_message": "2020-09-07T19:38:00-07:00",
   "cover_photo_url": "",
   "icon_url": "",
   "group_url": "",
   "allow_parent_subs_to_post": false,
   "send_event_summaries": false,
   "event_summary_schedule": "event_summary_weekly_friday",
   "send_invites_on_join": false,
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "email_address": "StrategyHub@groups.io",
   "extra_member_data_columns": [
     {
       "id": 48876437,
       "name": "Text: Lots write point week doctor.",
       "type": "text_column",
       "required": true,
       "color": "color_beige",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Movement whose also it vanish watch these to ever always."
     },
     {
       "id": 161476183,
       "name": "Paragraph: Other few covey range window.",
       "type": "paragraph_column",
       "required": true,
       "color": "color_light_brown",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Silence lastly had what outcome let while school pause up."
     },
     {
       "id": 39354277,
       "name": "Checkbox: Company freedom pout his throw.",
       "type": "checkbox_column",
       "required": true,
       "color": "color_orange",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Quarterly outfit faithful is often part whom these been hourly."
     },
     {
       "id": 8897324,
       "name": "Multiple Choice: Madagascan anyway should late yours.",
       "type": "multiple_choice_column",
       "required": true,
       "color": "color_orchid",
       "choices": [
         "Monthly ball upon almost everything dynasty.",
         "Behalf shall nearly this weekly for.",
         "Anywhere everybody over secondly then boat."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Besides pack when murder her had snore first in limp."
     },
     {
       "id": 159828550,
       "name": "Date: Which these bale nobody few.",
       "type": "date_column",
       "required": true,
       "color": "color_blush",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "How anyone these string life that who result lately yourselves."
     },
     {
       "id": 185149472,
       "name": "Time: Besides later whom for rarely.",
       "type": "time_column",
       "required": true,
       "color": "color_sage",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Each her ski ours host our as did they to."
     },
     {
       "id": 166814414,
       "name": "Address: Bravery where this as cloud.",
       "type": "address_column",
       "required": true,
       "color": "color_cucumber",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Inside since open most you that including fight murder cautiously."
     },
     {
       "id": 102385421,
       "name": "Multi Choice: Another what full her can.",
       "type": "multi_choice_column",
       "required": true,
       "color": "color_aquamute",
       "choices": [
         "Indeed besides motherhood in that nightly.",
         "Limit we kneel herself collect yourselves.",
         "Yourselves Norwegian this fear happily fruit."
       ],
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Pout nature bike moreover from whoever afterwards myself mine to."
     },
     {
       "id": 154317202,
       "name": "Link: Bale sedge Christian would whose.",
       "type": "link_column",
       "required": true,
       "color": "color_military",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Hers pack rhythm that now whose her out infancy somebody."
     },
     {
       "id": 123191768,
       "name": "Image: Today scenic consequently ours eye.",
       "type": "image_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Other other abundant some anywhere this life nevertheless in next."
     },
     {
       "id": 53386358,
       "name": "HTML Paragraph: Nobody what today e.g. loss.",
       "type": "html_paragraph_column",
       "required": true,
       "color": "color_emerald_green",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Spite Philippine before throughout wander of as there next of."
     },
     {
       "id": 45812071,
       "name": "Email: That because am terribly many.",
       "type": "email_column",
       "required": true,
       "color": "color_light_grey",
       "width": 0,
       "default_hidden": false,
       "profile": false,
       "description": "Because anyone does you hungrily can several might who monthly."
     }
   ]
}

The Group Alias Object

The group alias object.

Response Attributes

id number
object string	groupalias.
created date
updated date
name string	Name.
alias_group_id number	If not 0, this is not a real group, but an alias to another group.

Example Object

{
 "id": 68,
 "object": "groupalias",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "name": "example",
 "alias_group_id": 8,
}

The Group Alias List Object

/getgroupaliases return object.

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Group Alias objects

Methods That Use This Object

Get Group Aliases	View Method

Example Object

{
 "object": "list",
 "total_count": 97,
 "start_item": 1,
 "end_item": 88,
 "has_more": false,
 "next_page_token": 76,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 33,
    "object": "groupalias",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "name": "example",
    "alias_group_id": 96,
   }
 ],
}

The Group List Object

/getsubgroups return object.

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Group objects

Methods That Use This Object

Get Sub Groups	View Method

Example Object

{
 "object": "list",
 "total_count": 83,
 "start_item": 47,
 "end_item": 70,
 "has_more": false,
 "next_page_token": 19,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   }
 ],
}

The Hashtag Object

The hashtag object.

Response Attributes

id number	Unique ID of the hashtag object.
object string	hashtag.
created date
group_id number
name string
alias optional Hashtag object
mods_only_post boolean
mods_only_replies boolean
no_email boolean
moderated boolean
special boolean
replies_unmoderated boolean
locked boolean
until string	Can be one of: `hashtag_delete_day`, `hashtag_delete_forever`, `hashtag_delete_hour`, `hashtag_delete_month`, `hashtag_delete_six_months`, `hashtag_delete_three_months`, `hashtag_delete_week`, `hashtag_delete_year`.
close_instead_of_delete boolean
description string
color_name string	Can be one of: `color_antique_pink`, `color_apricot`, `color_aquamute`, `color_beige`, `color_bluejean`, `color_blush`, `color_burnt_yellow`, `color_capri_blue`, `color_cerulean_blue`, `color_cherry_blossom`, `color_cloudy_blue`, `color_cucumber`, `color_dark_grey`, `color_dark_orange`, `color_dusty_mauve`, `color_emerald_green`, `color_grape`, `color_green_lantern`, `color_green_sage`, `color_grey_blue`, `color_light_brown`, `color_light_grey`, `color_light_lilac`, `color_lilac`, `color_lips`, `color_melon`, `color_military`, `color_moss_green`, `color_mulbery`, `color_mustard`, `color_none`, `color_orange`, `color_orchid`, `color_peony`, `color_pink`, `color_purple`, `color_purple_blue`, `color_purple_grey`, `color_sage`, `color_sky`, `color_terracotta`, `color_tomato`, `color_yellow`.
color_hex string
reply_to string	Can be one of: `thread_reply_group_default`, `thread_reply_only_to_sender`, `thread_reply_to_followers_only`, `thread_reply_to_group`, `thread_reply_to_group_and_sender`, `thread_reply_to_moderators`, `thread_reply_to_sender`.
topic_count number
last_message_date date
muted boolean	If true, the user is muting this hashtag. This is an optional field.
followed boolean	If true, the user is following this hashtag. This is an optional field.

Methods That Use This Object

New Hashtag	View Method
Update Hashtag	View Method

Example Object

{
   "id": 541,
   "object": "hashtag",
   "created": "2020-09-17T11:22:00-07:00",
   "group_id": 1188,
   "name": "Karl",
   "mods_only_post": false,
   "mods_only_replies": false,
   "no_email": false,
   "moderated": false,
   "special": true,
   "replies_unmoderated": false,
   "locked": true,
   "until": "hashtag_delete_month",
   "close_instead_of_delete": true,
   "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
   "color_name": "pink",
   "color_hex": "#f39de4",
   "reply_to": "thread_reply_to_sender",
   "topic_count": 1789,
   "last_message_date": "2020-09-08T01:22:00-07:00",
   "muted": null,
   "followed": null
}

The Hashtag List Object

Hashtag List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Hashtag objects

Methods That Use This Object

Get Hashtags	View Method

Example Object

{
 "object": "list",
 "total_count": 22,
 "start_item": 36,
 "end_item": 3,
 "has_more": false,
 "next_page_token": 23,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   }
 ],
}

The Login Object

The login object.

Response Attributes

user User object
token optional string	If using the token login, this is the token to pass in.

Methods That Use This Object

Login	View Method
Authenticate Login Link	View Method
Facebook Login Final	View Method
Apple Login Final	View Method
Google Login Final	View Method
Register User	View Method

Example Object

{
 "user": 
   {
      "id": 147779411,
      "object": "user",
      "created": "2020-09-01T08:47:00-07:00",
      "updated": "2022-03-01T17:18:00-08:00",
      "email": "gersonbeahan@jacobi.io",
      "full_name": "Lawson Kreiger",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "status": "user_status_confirmed",
      "profile_photo_url": "",
      "post_pref": "user_postpref_html",
      "per_page_pref": "user_per_page_pref20",
      "allow_facebook_login": false,
      "allow_google_login": false,
      "allow_sso_login": false,
      "csrf_token": "84491575",
      "two_factor_enabled": false,
      "recovery_codes": "",
      "dont_munge_message_id": false,
      "about_me": "Today awfully arrive at",
      "about_format": "about_html",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "time_pref": "standard_time",
      "date_pref": "us_date",
      "monday_start": false,
      "profile_privacy": "profile_private",
      "default_message_view": "thread_view",
      "topics_sort_dir": "sort_none",
      "topic_sort_dir": "sort_none",
      "messages_sort_dir": "sort_none",
      "expanded_messages_sort_dir": "sort_none",
      "search_sort": "relevance_sort",
      "search_sort_dir": "sort_none",
      "photos_order_by": "",
      "photos_sort_dir": "sort_none",
      "album_order_by": "",
      "album_sort_dir": "sort_none",
      "default_calendar_view": "cal_view_month",
      "default_hashtag_view": "view_grid",
      "default_rsvp_view": "view_grid",
      "home_page": "home_page_feed"
   },
 "token": "aabbffed2213234",
}

The Member Info Object

The member info object. This represents a subscription to a group. Fields marked as optional may not always be returned, depending on the call returning this object.

Response Attributes

id number	Unique ID of the member_info object.
object string	member_info.
created date	The time that this object was created.
updated date	The time that this object was last updated.
user_id number	ID of the member.
group_id number	ID of the group.
group_name string	Name of the group.
status optional string	Member status. Can be one of: `sub_status_banned`, `sub_status_normal`, `sub_status_pending`.
post_status optional string	Posting status. Can be one of: `sub_poststatus_allowed`, `sub_poststatus_mod_first_message`, `sub_poststatus_mod_started_topics`, `sub_poststatus_moderated`, `sub_poststatus_newusermoderated`, `sub_poststatus_normal`, `sub_poststatus_notallowed`.
email_delivery optional string	Email delivery. Can be one of: `email_delivery_digest`, `email_delivery_html_digest`, `email_delivery_none`, `email_delivery_single`, `email_delivery_special`, `email_delivery_summary`.
message_selection optional string	Message selection. Can be one of: `message_selection_all`, `message_selection_follow_and_first_message`, `message_selection_follow_only`.
auto_follow_replies optional boolean
max_attachment_size optional string	Max attachment size. Can be one of: `max_attachment_size_large`, `max_attachment_size_medium`, `max_attachment_size_none`, `max_attachment_size_small`, `max_attachment_size_unlimited`.
approved_posts optional number	The count of consecutive approved posts. Only applicable when post_status is `sub_poststatus_newusermoderated`.
mod_status optional string	Moderator data. Can be one of: `sub_modstatus_moderator`, `sub_modstatus_none`, `sub_modstatus_owner`.
pending_msg_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
pending_sub_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
sub_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
storage_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
sub_group_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
message_report_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
account_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
mod_permissions optional string	Can be more than one of: `sub_perm_banmembers`, `sub_perm_billing`, `sub_perm_editarchives`, `sub_perm_groupsettings`, `sub_perm_integrations`, `sub_perm_invitemembers`, `sub_perm_makemoderator`, `sub_perm_managehashtags`, `sub_perm_managepaidsubscriptions`, `sub_perm_managesubgroups`, `sub_perm_modsub`, `sub_perm_none`, `sub_perm_pendingmembers`, `sub_perm_pendingmsgs`, `sub_perm_removemembers`, `sub_perm_viewmembers`.
owner_msg_notify optional string	Can be one of: `sub_ownermsg_notify_all`, `sub_ownermsg_notify_none`, `sub_ownermsg_notify_subs`.
chat_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
photo_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
file_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
wiki_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
database_notify optional string	Can be one of: `sub_notify_app_only`, `sub_notify_email_and_app`, `sub_notify_email_only`, `sub_notify_none`.
email optional string	The email address of the member.
user_status optional string	User status. Can be one of: `user_status_bounced`, `user_status_bouncing`, `user_status_confirmed`, `user_status_failed_reverify`, `user_status_inactive`, `user_status_not_confirmed`.
user_name string	User name.
timezone optional string	Time zone.
full_name string	Full name.
about_me optional string	About me, in HTML format.
location optional string	Location.
website optional string	Website, typically a URL.
profile_photo_url optional string	Empty if no profile photo.
profile_privacy optional string	Profile privacy. Can be one of: `profile_members`, `profile_private`, `profile_public`.
dont_munge_message_id optional boolean
use_signature optional boolean	Insert the signature into messages posted from the Groups.io website.
use_signature_email optional boolean	Insert the signature into messages sent via email.
signature optional string	Signature.
moderator_notes optional string	Any moderator notes. The moderator_notes field is only set when an account with the appropriate permissions requests this.
moderator_notes_updated optional date	The last time the moderator_notes field was updated. The moderator_notes_updated field is only set when an account with the appropriate permissions requests this.
color optional string	Member color. Can be one of: `color_antique_pink`, `color_apricot`, `color_aquamute`, `color_beige`, `color_bluejean`, `color_blush`, `color_burnt_yellow`, `color_capri_blue`, `color_cerulean_blue`, `color_cherry_blossom`, `color_cloudy_blue`, `color_cucumber`, `color_dark_grey`, `color_dark_orange`, `color_dusty_mauve`, `color_emerald_green`, `color_grape`, `color_green_lantern`, `color_green_sage`, `color_grey_blue`, `color_light_brown`, `color_light_grey`, `color_light_lilac`, `color_lilac`, `color_lips`, `color_melon`, `color_military`, `color_moss_green`, `color_mulbery`, `color_mustard`, `color_none`, `color_orange`, `color_orchid`, `color_peony`, `color_pink`, `color_purple`, `color_purple_blue`, `color_purple_grey`, `color_sage`, `color_sky`, `color_terracotta`, `color_tomato`, `color_yellow`.
num_drafts optional number	The number of drafts this person has open in this group. This field is only set by the `getsubscriptions` endpoint.
pending_subs optional number	The number of pending subscribers this group has.
pending_msgs optional number	The number of pending messages this group has.
cover_photo_url string	URL of the group cover photo.
icon_url string	URL of the group icon.
nice_group_name string	Nice version of the group name.
subs_count number	Number of subscribers in the group.
most_recent_message date
perms optional Perms object	Group permissions this member has.
delivery_info optional Delivery Info object	Delivery information.
member_labels optional array of MemberLabel objects	Member labels.
extra_member_data optional array of Database Value objects	Extra member data.

Methods That Use This Object

Approve Pending Member	View Method
Ban Member	View Method
Bulk Remove Members	View Method
Get Member	View Method
Remove Member	View Method
Send A Bounce Probe	View Method
Send A Confirmation Email	View Method
Update Member	View Method
Get Subscription	View Method
Update Subscription	View Method

Example Object

{
   "id": 93846546,
   "object": "member_info",
   "created": "2020-09-09T04:11:00-07:00",
   "updated": "2022-06-08T07:16:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "group_name": "StrategyHub",
   "status": "sub_status_normal",
   "post_status": "sub_poststatus_newusermoderated",
   "email_delivery": "email_delivery_digest",
   "message_selection": "message_selection_follow_and_first_message",
   "auto_follow_replies": false,
   "max_attachment_size": "max_attachment_size_medium",
   "approved_posts": 0,
   "mod_status": "sub_modstatus_owner",
   "pending_msg_notify": "sub_notify_email_and_app",
   "pending_sub_notify": "sub_notify_email_and_app",
   "sub_notify": "sub_notify_email_and_app",
   "storage_notify": "sub_notify_email_and_app",
   "sub_group_notify": "sub_notify_email_and_app",
   "message_report_notify": "sub_notify_email_and_app",
   "account_notify": "sub_notify_email_and_app",
   "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
   "owner_msg_notify": "sub_ownermsg_notify_subs",
   "chat_notify": "sub_notify_email_and_app",
   "photo_notify": "sub_notify_email_and_app",
   "file_notify": "sub_notify_email_and_app",
   "wiki_notify": "sub_notify_email_and_app",
   "database_notify": "sub_notify_email_and_app",
   "email": "gersonbeahan@jacobi.io",
   "user_status": "user_status_confirmed",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "full_name": "Lawson Kreiger",
   "about_me": "Today awfully arrive at",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "profile_privacy": "profile_private",
   "dont_munge_message_id": false,
   "use_signature": false,
   "use_signature_email": false,
   "signature": "In hotel furniture anyone weakly besides",
   "color": "color_cerulean_blue",
   "cover_photo_url": "",
   "icon_url": "",
   "nice_group_name": "",
   "subs_count": 0,
   "most_recent_message": "0001-01-01T00:00:00Z",
   "perms": {
     "object": "perms",
     "archives_visible": true,
     "polls_visible": true,
     "members_visible": true,
     "chat_visible": true,
     "calendar_visible": true,
     "files_visible": true,
     "database_visible": true,
     "photos_visible": true,
     "wiki_visible": true,
     "member_directory_visible": true,
     "hashtags_visible": true,
     "guidelines_visible": true,
     "subgroups_visible": true,
     "open_donations_visible": true,
     "sponsor_visible": true,
     "manage_subgroups": true,
     "ask_visible": true,
     "delete_group": true,
     "download_archives": true,
     "download_entire_group": true,
     "download_members": true,
     "view_activity": true,
     "create_hashtags": true,
     "manage_hashtags": true,
     "manage_integrations": true,
     "manage_group_settings": true,
     "make_moderator": true,
     "manage_member_subscription_options": true,
     "manage_pending_members": true,
     "remove_members": true,
     "ban_members": true,
     "manage_group_billing": true,
     "manage_group_payments": true,
     "edit_archives": true,
     "manage_pending_messages": true,
     "invite_members": true,
     "can_post": true,
     "can_reply": true,
     "can_vote": true,
     "manage_polls": true,
     "manage_photos": true,
     "manage_members": true,
     "manage_calendar": true,
     "manage_chats": true,
     "view_member_directory": true,
     "manage_files": true,
     "manage_wiki": true,
     "manage_subscription": true,
     "public_page": true,
     "sub_page": true,
     "mod_page": true,
     "can_ask": true
   },
   "member_labels": [
     {
       "id": 726,
       "object": "memberlabel",
       "created": "2020-09-29T22:19:00Z",
       "group_id": 1857,
       "name": "Florida",
       "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
       "color_name": "green-sage",
       "color_hex": "#9fc4ac"
     },
     {
       "id": 1594,
       "object": "memberlabel",
       "created": "2020-09-24T02:24:00Z",
       "group_id": 42,
       "name": "Russel",
       "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
       "color_name": "purple",
       "color_hex": "#837fd5"
     },
     {
       "id": 1189,
       "object": "memberlabel",
       "created": "2020-09-12T02:11:00Z",
       "group_id": 1474,
       "name": "Meta",
       "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
       "color_name": "sky",
       "color_hex": "#9cc7df"
     }
   ],
   "extra_member_data": [
     {
       "col_id": 48876437,
       "col_type": "text_column",
       "text": "To firstly unlock while host himself me purely as whose."
     },
     {
       "col_id": 161476183,
       "col_type": "paragraph_column",
       "text": "Yet few mustering example will addition yearly since in these."
     },
     {
       "col_id": 39354277,
       "col_type": "checkbox_column",
       "checked": false
     },
     {
       "col_id": 8897324,
       "col_type": "multiple_choice_column",
       "multi_choice": [
         0
       ]
     },
     {
       "col_id": 159828550,
       "col_type": "date_column",
       "date": "1916-10-16T17:57:55.797000001Z"
     },
     {
       "col_id": 185149472,
       "col_type": "time_column",
       "time": "1919-03-30T18:00:36.790929649Z"
     },
     {
       "col_id": 166814414,
       "col_type": "address_column",
       "street_address1": "Premier Medical Group",
       "street_address2": "3701 DAUPHIN ST",
       "city": "MOBILE",
       "state": "AL",
       "zip": "36608-1756",
       "lat": 30.6866076,
       "lng": -88.13019249999999
     },
     {
       "col_id": 102385421,
       "col_type": "multi_choice_column",
       "multi_choice": [
         0,
         1,
         2
       ]
     },
     {
       "col_id": 154317202,
       "col_type": "link_column",
       "title": "To say poorly out according abundant unless nervously string lastly.",
       "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
       "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
     },
     {
       "col_id": 123191768,
       "col_type": "image_column",
       "url": "https://picsum.photos/id/27/187/110",
       "image_name": "Lately blazer with wild hourly there she it infrequently power."
     },
     {
       "col_id": 53386358,
       "col_type": "html_paragraph_column",
       "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
     },
     {
       "col_id": 45812071,
       "col_type": "email_column",
       "text": "brantkozey@bernhard.com"
     }
   ]
}

The Member Info List Object

The Member Info List object contains a list of Member Info objects.

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Member Info objects

Methods That Use This Object

Chat Members	View Method
Get Member Directory	View Method
Get Members	View Method
Search Member Directory	View Method
Search Members	View Method
Get Subscriptions	View Method

Example Object

{
 "object": "list",
 "total_count": 55,
 "start_item": 7,
 "end_item": 57,
 "has_more": false,
 "next_page_token": 13,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
}

The Member Notice Object

The member notice object.

Response Attributes

id number	Unique ID of the member_notice object.
object string	member_notice.
created date
updated date
group_id number
type string	Type of member notice. Can be one of: `member_notice_banned`, `member_notice_direct_add`, `member_notice_guidelines`, `member_notice_invite`, `member_notice_joining`, `member_notice_leaving`, `member_notice_locked_group`, `member_notice_locked_topic`, `member_notice_monthly_reminder`, `member_notice_pending`, `member_notice_post_to_sub`, `member_notice_rejected_message`, `member_notice_rejected_sub`, `member_notice_removed_sub`, `member_notice_sponsorship`.
name string	Name of this member notice.
subject string	Subject used when sending emails.
message string	The message, in HTML format.
is_default boolean	Use this message for email commands.
send_monthly boolean	For Guidelines, send monthly to the group members.
send_monthly_special boolean	For Guidelines, send monthly to members on special only.
send_on_join boolean	For Guidelines, send to new members at same time as welcome message.
private boolean	For Guidelines, if the guidelines are public or for members only.
guidelines_monthly_subject string	For Guidelines, the subject to use when sending the monthly email.

Methods That Use This Object

New Member Notice	View Method
Update Member Notice	View Method

Example Object

{
 "id": 42,
 "object": "member_notice",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 99,
 "type": "member_notice_banned",
 "name": "",
 "subject": "",
 "message": "",
 "is_default": false,
 "send_monthly": false,
 "send_monthly_special": false,
 "send_on_join": false,
 "private": false,
 "guidelines_monthly_subject": "",
}

The Member Notice List Object

Member Notice List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Member Notice objects

Methods That Use This Object

Get Member Notices	View Method

Example Object

{
 "object": "list",
 "total_count": 3,
 "start_item": 45,
 "end_item": 93,
 "has_more": false,
 "next_page_token": 40,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 85,
    "object": "member_notice",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 98,
    "type": "member_notice_banned",
    "name": "",
    "subject": "",
    "message": "",
    "is_default": false,
    "send_monthly": false,
    "send_monthly_special": false,
    "send_on_join": false,
    "private": false,
    "guidelines_monthly_subject": "",
   }
 ],
}

The MemberLabel Object

The member label object.

Response Attributes

id number	Unique ID of the memberlabel object.
object string	memberlabel.
created date
group_id number
name string
description string
color_name string	Can be one of: `color_antique_pink`, `color_apricot`, `color_aquamute`, `color_beige`, `color_bluejean`, `color_blush`, `color_burnt_yellow`, `color_capri_blue`, `color_cerulean_blue`, `color_cherry_blossom`, `color_cloudy_blue`, `color_cucumber`, `color_dark_grey`, `color_dark_orange`, `color_dusty_mauve`, `color_emerald_green`, `color_grape`, `color_green_lantern`, `color_green_sage`, `color_grey_blue`, `color_light_brown`, `color_light_grey`, `color_light_lilac`, `color_lilac`, `color_lips`, `color_melon`, `color_military`, `color_moss_green`, `color_mulbery`, `color_mustard`, `color_none`, `color_orange`, `color_orchid`, `color_peony`, `color_pink`, `color_purple`, `color_purple_blue`, `color_purple_grey`, `color_sage`, `color_sky`, `color_terracotta`, `color_tomato`, `color_yellow`.
color_hex string

Example Object

{
 "id": 24,
 "object": "memberlabel",
 "created": "2009-11-10T15:00:00-08:00",
 "group_id": 71,
 "name": "",
 "description": "",
 "color_name": "color_antique_pink",
 "color_hex": "",
}

The MemberLabel List Object

MemberLabel List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of MemberLabel objects

Example Object

{
 "object": "list",
 "total_count": 36,
 "start_item": 17,
 "end_item": 50,
 "has_more": false,
 "next_page_token": 5,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 69,
    "object": "memberlabel",
    "created": "2009-11-10T15:00:00-08:00",
    "group_id": 43,
    "name": "",
    "description": "",
    "color_name": "color_antique_pink",
    "color_hex": "",
   }
 ],
}

The Message Object

The message object.

Response Attributes

id number
object string	message.
created date
updated date
user_id number
group_id number
topic_id number
body string	body of the message to display, minus any quoted section at the end.
quoted string	any quoted section at the end of the message.
remainder string	for HTML messages, there may be a remainder part with just closing html tags.
snippet string	Snippet, used for collapsed messages display.
subject string	Subject of the message, without hashtags.
subject_with_tags string	Subject with any hashtags.
name string
profile_photo_url string	If not empty, use this URL to fetch the profile photo associated with the author of this message.
is_plain_text boolean
msg_num number
is_reply boolean	If this message is a reply.
has_liked boolean	If we've liked this message.
num_likes number	Number of likes, not including our own.
is_closed boolean	If the thread this message is a part of is closed.
is_moderated boolean	If the thread this message is a part of is moderated.
reply_to string	ReplyTo for this message (normally Group.ReplyTo unless modified by a tag). Can be one of: `group_reply_only_to_sender`, `group_reply_to_followers_only`, `group_reply_to_group`, `group_reply_to_group_and_sender`, `group_reply_to_group_id`, `group_reply_to_moderators`, `group_reply_to_sender`.
can_repost boolean	if we can repost this message.
hashtags array of Hashtag objects
poll_id number	If this is a Poll, this is the ID of the Poll object.
attachments array of Attachment objects

Example Object

{
 "id": 51,
 "object": "message",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 42,
 "group_id": 9,
 "topic_id": 66,
 "body": "",
 "quoted": "",
 "remainder": "",
 "snippet": "",
 "subject": "",
 "subject_with_tags": "",
 "name": "",
 "profile_photo_url": "",
 "is_plain_text": false,
 "msg_num": 83,
 "is_reply": false,
 "has_liked": false,
 "num_likes": 34,
 "is_closed": false,
 "is_moderated": false,
 "reply_to": "group_reply_only_to_sender",
 "can_repost": false,
 "hashtags": [
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   }
 ],
 "poll_id": 26,
 "attachments": [
   {
    "id": 48,
    "media_type": "",
    "download_url": "",
    "image_thumbnail_url": "",
    "filename": "",
   }
 ],
}

The Message History Object

The message history object.

Response Attributes

object string	message_history.
month_counts array of Month Count objects	Array of sets of 12 month_count objects.
tz_offset number	Timezone offset, in minutes difference to UTC.

Methods That Use This Object

Get Message History	View Method

Example Object

{
 "object": "message_history",
 "month_counts": [
   {
    "object": "month_count",
    "year": 77,
    "month": 20,
    "msgs_sent": 41,
   }
 ],
 "tz_offset": 61,
}

The Message List Object

Message List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
group_perms optional Perms object
group optional Group object
cover_photo_url optional string
sub_data optional array of Member Info objects
topic optional Topic object
data array of Message objects

Methods That Use This Object

Get Topic	View Method
Get Messages	View Method

Example Object

{
 "object": "list",
 "total_count": 0,
 "start_item": 76,
 "end_item": 57,
 "has_more": false,
 "next_page_token": 43,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "group_perms": 
   {
      "object": "perms",
      "archives_visible": true,
      "polls_visible": true,
      "members_visible": true,
      "chat_visible": true,
      "calendar_visible": true,
      "files_visible": true,
      "database_visible": true,
      "photos_visible": true,
      "wiki_visible": true,
      "member_directory_visible": true,
      "hashtags_visible": true,
      "guidelines_visible": true,
      "subgroups_visible": true,
      "open_donations_visible": true,
      "sponsor_visible": true,
      "manage_subgroups": true,
      "ask_visible": true,
      "delete_group": true,
      "download_archives": true,
      "download_entire_group": true,
      "download_members": true,
      "view_activity": true,
      "create_hashtags": true,
      "manage_hashtags": true,
      "manage_integrations": true,
      "manage_group_settings": true,
      "make_moderator": true,
      "manage_member_subscription_options": true,
      "manage_pending_members": true,
      "remove_members": true,
      "ban_members": true,
      "manage_group_billing": true,
      "manage_group_payments": true,
      "edit_archives": true,
      "manage_pending_messages": true,
      "invite_members": true,
      "can_post": true,
      "can_reply": true,
      "can_vote": true,
      "manage_polls": true,
      "manage_photos": true,
      "manage_members": true,
      "manage_calendar": true,
      "manage_chats": true,
      "view_member_directory": true,
      "manage_files": true,
      "manage_wiki": true,
      "manage_subscription": true,
      "public_page": true,
      "sub_page": true,
      "mod_page": true,
      "can_ask": true
   },
 "group": 
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   },
 "cover_photo_url": "",
 "sub_data": [
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   }
 ],
 "topic": 
   {
      "id": 52691321,
      "object": "topic",
      "created": "2020-09-15T02:30:00-07:00",
      "updated": "2021-03-01T18:07:00-08:00",
      "group_id": 8658933,
      "group_subject_tag": "[StrategyHub]",
      "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
      "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
      "name": "Elenor Schaefer",
      "profile_photo_url": "",
      "num_messages": 22,
      "is_sticky": false,
      "is_moderated": false,
      "is_closed": false,
      "has_attachments": false,
      "reply_to": "thread_reply_group_default",
      "most_recent_message": "2020-09-29T17:03:00-07:00",
      "hashtags": null
   },
 "data": [
   {
    "id": 42,
    "object": "message",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 20,
    "group_id": 45,
    "topic_id": 78,
    "body": "",
    "quoted": "",
    "remainder": "",
    "snippet": "",
    "subject": "",
    "subject_with_tags": "",
    "name": "",
    "profile_photo_url": "",
    "is_plain_text": false,
    "msg_num": 34,
    "is_reply": false,
    "has_liked": false,
    "num_likes": 28,
    "is_closed": false,
    "is_moderated": false,
    "reply_to": "group_reply_only_to_sender",
    "can_repost": false,
    "hashtags": [
      {
         "id": 541,
         "object": "hashtag",
         "created": "2020-09-17T11:22:00-07:00",
         "group_id": 1188,
         "name": "Karl",
         "mods_only_post": false,
         "mods_only_replies": false,
         "no_email": false,
         "moderated": false,
         "special": true,
         "replies_unmoderated": false,
         "locked": true,
         "until": "hashtag_delete_month",
         "close_instead_of_delete": true,
         "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
         "color_name": "pink",
         "color_hex": "#f39de4",
         "reply_to": "thread_reply_to_sender",
         "topic_count": 1789,
         "last_message_date": "2020-09-08T01:22:00-07:00",
         "muted": null,
         "followed": null
      }
    ],
    "poll_id": 15,
    "attachments": [
      {
       "id": 87,
       "media_type": "",
       "download_url": "",
       "image_thumbnail_url": "",
       "filename": "",
      }
    ],
   }
 ],
}

The Message Search Result Object

The message search result object.

Response Attributes

id number
object string	message_search_result.
created date
updated date
group_id number
topic_id number
summary string	Results summary, in HTML.
subject string	Subject of the message.
body string	Plain text body of the message, restricted to the first 500,000 bytes.
user_id number
profile_photo_url string	If not empty then there is a profile photo associated with this votor.
name string	Name of the person who voted.
can_view_profile boolean	If the person viewing this poll can view the profile.
rev_count number	If > 0, then this message has been edited.
msg_num number	The msg number of the message, if this is a message.
num_msgs_in_topic number
is_closed boolean	If the topic this message is a part of is closed.
is_moderated boolean	If the topic this message is a part of is moderated.
is_sticky boolean	If this topic has been marked as sticky.
has_attachments boolean	If this message has attachments.
hashtags array of Hashtag objects

Example Object

{
 "id": 19,
 "object": "message_search_result",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 24,
 "topic_id": 3,
 "summary": "",
 "subject": "",
 "body": "",
 "user_id": 1,
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "rev_count": 40,
 "msg_num": 35,
 "num_msgs_in_topic": 70,
 "is_closed": false,
 "is_moderated": false,
 "is_sticky": false,
 "has_attachments": false,
 "hashtags": [
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   }
 ],
}

The Message Search Results List Object

Message Search Results List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
profile_photo_url string	If not empty then there is a profile photo associated with this votor.
name string	Name of the person who voted.
can_view_profile boolean	If the person viewing this poll can view the profile.
query string	The query string.
collapse_topics boolean	If the results have collapsed topics.
exclude_sigs boolean	If the results exclude signature matches.
start_date optional date	Optional start date of the search.
end_date optional date	Optional end date of the search.
preset_date_range string	Optional preset date range of the search.
hashtag Hashtag object	If this search is of a hashtag. The hashtag is pulled from the query string.
poster_user_id number	If this search is limited to a specific poster, this is their user_id. The `poster_profile_photo_url`, `poster_name`, and `can_view_poster_profile` fields are only set if this search is limited to a specific poster. The poster is pulled from the query string.
profile_photo_url string	If not empty then there is a profile photo associated with this votor.
name string	Name of the person who voted.
can_view_profile boolean	If the person viewing this poll can view the profile.
data array of Message Search Result objects

Methods That Use This Object

Search Archives	View Method

Example Object

{
 "object": "list",
 "total_count": 35,
 "start_item": 54,
 "end_item": 54,
 "has_more": false,
 "next_page_token": 36,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "query": "",
 "collapse_topics": false,
 "exclude_sigs": false,
 "start_date": "2009-11-10T15:00:00-08:00",
 "end_date": "2009-11-10T15:00:00-08:00",
 "preset_date_range": "",
 "hashtag": 
   {
      "id": 541,
      "object": "hashtag",
      "created": "2020-09-17T11:22:00-07:00",
      "group_id": 1188,
      "name": "Karl",
      "mods_only_post": false,
      "mods_only_replies": false,
      "no_email": false,
      "moderated": false,
      "special": true,
      "replies_unmoderated": false,
      "locked": true,
      "until": "hashtag_delete_month",
      "close_instead_of_delete": true,
      "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
      "color_name": "pink",
      "color_hex": "#f39de4",
      "reply_to": "thread_reply_to_sender",
      "topic_count": 1789,
      "last_message_date": "2020-09-08T01:22:00-07:00",
      "muted": null,
      "followed": null
   },
 "poster_user_id": 15,
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "data": [
   {
    "id": 42,
    "object": "message_search_result",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 20,
    "topic_id": 7,
    "summary": "",
    "subject": "",
    "body": "",
    "user_id": 10,
    "profile_photo_url": "",
    "name": "",
    "can_view_profile": false,
    "rev_count": 16,
    "msg_num": 87,
    "num_msgs_in_topic": 42,
    "is_closed": false,
    "is_moderated": false,
    "is_sticky": false,
    "has_attachments": false,
    "hashtags": [
      {
         "id": 541,
         "object": "hashtag",
         "created": "2020-09-17T11:22:00-07:00",
         "group_id": 1188,
         "name": "Karl",
         "mods_only_post": false,
         "mods_only_replies": false,
         "no_email": false,
         "moderated": false,
         "special": true,
         "replies_unmoderated": false,
         "locked": true,
         "until": "hashtag_delete_month",
         "close_instead_of_delete": true,
         "description": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever. E.g. fear usually body kilometer nightly child so firstly he. Next each secondly must catch politely sleepy where i.e. inquisitively. Yours wisp regularly nice cackle ourselves heavily now this our. Yearly what few why where win most would everybody them.",
         "color_name": "pink",
         "color_hex": "#f39de4",
         "reply_to": "thread_reply_to_sender",
         "topic_count": 1789,
         "last_message_date": "2020-09-08T01:22:00-07:00",
         "muted": null,
         "followed": null
      }
    ],
   }
 ],
}

The Month Count Object

The month count object.

Response Attributes

object string	month_count.
year number	Year.
month number	Month.
msgs_sent number	Number of messages sent that month.

Example Object

{
 "object": "month_count",
 "year": 52,
 "month": 0,
 "msgs_sent": 3,
}

The Oauth Login Object

The Oauth Login object.

Response Attributes

object string	oauth_login.
state string
web_client_id string	Client ID needed for web applications.
ios_client_id string	Client ID needed for IOS applications.
android_client_id string	Client ID needed for Android applications.
scopes array of string

Methods That Use This Object

Facebook Login Start	View Method
Apple Login Start	View Method
Google Login Start	View Method

Example Object

{
 "object": "oauth_login",
 "state": "12345",
 "web_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "ios_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "android_client_id": "EAAV5drZBzQ3IBALC8Wt86UsiAa0dK95svJU32FQusEIqeHZC",
 "scopes": ["user"],
}

The Org Object

The org object.

Response Attributes

id number	Unique ID of the org object.
object string	org.
created date	Time object was created.
updated date	Time object was last updated.
title string	Title of the organization.
domain string	Domain of the organization.
parent_group_id number	ID of the parent group for this org (each org has 1 parent group).
logged_out_wiki_page_id number	If not 0, the ID of the WikiPage to display for logged out people visiting the domain.
default_timezone string	For users created in this timezone.
disable_signup boolean	Don't allow access to any group page at all if not signed in.
disable_plus_one boolean	Don't treat +1 emails as likes.
ga_code string	Google Analytics code.
login_page_text string	Replace the standard text at the bottom of the login page.
no_account_text string	Text displayed on the send login link page.
sso_provider string	If this org uses an SSO identity provider. Can be one of: `no_sso`, `sso_auth0`, `sso_club_express`, `sso_mini_orange`, `sso_novi_ams`, `sso_test`, `sso_your_membership`, `ssosaml_generic`, `ssosaml_google`, `ssosaml_microsoft`, `ssosaml_okta`, `ssosaml_one_login`, `ssosaml_ping_identity`, `ssosamladfs`.
sso_client_id string	SSO Client ID.
sso_client_secret string	SSO Client Secret.
sso_domain string	SSO Domain.

Methods That Use This Object

Get Org	View Method

Example Object

{
   "id": 1,
   "object": "org",
   "created": "1969-12-31T16:00:00-08:00",
   "updated": "1969-12-31T16:00:00-08:00",
   "title": "Groups.io",
   "domain": "groups.io",
   "parent_group_id": 0,
   "logged_out_wiki_page_id": 0,
   "default_timezone": "",
   "disable_signup": false,
   "disable_plus_one": false,
   "ga_code": "",
   "login_page_text": "",
   "no_account_text": "",
   "sso_provider": "no_sso",
   "sso_client_id": "",
   "sso_client_secret": "",
   "sso_domain": ""
}

The Pagination Object

The pagination object is returned with every API response that takes pagination parameters.

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc"
}

The Past Member Object

The Past Member object contains the information associated with a member subscription that no longer exists. Because a member may be removed from multiple groups at once, the Past Member object may contain multiple member_info objects.

Response Attributes

id number
object string	past_member.
created date	The time that this record was created.
action string	The reason for the unsubscription. Can be one of: `accepted_invitation`, `added_album`, `added_alias`, `added_banned_domain`, `added_bluesky_integration`, `added_dir`, `added_email_integration`, `added_event`, `added_facebook_integration`, `added_file`, `added_github_integration`, `added_group_alias`, `added_group_notice`, `added_hashtag`, `added_instagram_integration`, `added_member`, `added_member_label`, `added_photo`, `added_repeat_event`, `added_row`, `added_rss_integration`, `added_table`, `added_trello_integration`, `added_wiki_image`, `added_wiki_page`, `applied`, `approved_member`, `approved_pending_message`, `attachments_deleted_for_space`, `attempt_sub_banned_member`, `attempted_banned_domain_owner`, `attempted_banned_domain_post`, `attempted_banned_domain_registration`, `attempted_file_add_with_virus`, `bad_expired_thread`, `banned_by_system`, `banned_member`, `bounced_user`, `bouncing_user`, `canceled_event`, `changed_email`, `changed_fullname`, `changed_payer`, `changed_thread_replyto`, `changed_thread_subject`, `changed_username`, `claimed_pending_member`, `claimed_pending_message`, `closed_thread`, `color_changed`, `confirmed_account`, `created_group`, `created_subgroup`, `deleted_account`, `deleted_album`, `deleted_alias`, `deleted_attachment`, `deleted_banned_domain`, `deleted_chat_message`, `deleted_dir`, `deleted_event`, `deleted_file`, `deleted_following_repeat_event`, `deleted_group_alias`, `deleted_group_notice`, `deleted_message`, `deleted_message_edit`, `deleted_pending_message`, `deleted_photo`, `deleted_repeat_event`, `deleted_row`, `deleted_subgroup`, `deleted_table`, `deleted_thread`, `deleted_wiki_image`, `deleted_wiki_page`, `deleted_wiki_rev`, `delivery_changed`, `delivery_changed_by_moderator`, `donation_closed`, `donation_reopened`, `donation_requested`, `donation_updated`, `edited_album`, `edited_bluesky_integration`, `edited_email_integration`, `edited_extra_data`, `edited_facebook_integration`, `edited_github_integration`, `edited_group`, `edited_group_notice`, `edited_hashtag`, `edited_instagram_integration`, `edited_member_label`, `edited_message`, `edited_message_no_send_unused`, `edited_moderator_note`, `edited_photo`, `edited_rss_integration`, `edited_trello_integration`, `event_changed_rsvp`, `event_moved_from_waitlist`, `event_rsvp_maybe`, `event_rsvp_no`, `event_rsvp_yes`, `expired_hashtag`, `expired_member`, `expired_pending_message`, `exported_group`, `extra_data_changed_by_moderator`, `guidelines_sent`, `invited_member`, `joined`, `left`, `locked_event`, `member_donated`, `member_donation_failed`, `member_label_changed`, `member_sponsored`, `member_sponsorship_failed`, `merge_threads`, `message_to_attendees`, `mod_changed_email`, `mod_changed_fullname`, `moderated_thread`, `moderator_changed`, `modified_dir`, `modified_event`, `modified_file`, `modified_repeat_event`, `modified_row`, `modified_table`, `modified_wiki_page`, `monthly_reminder_sent`, `moved_dir`, `moved_file`, `moved_photo`, `notifications_changed`, `notifications_changed_by_moderator`, `paid_invoice`, `plan_change`, `post_to_sub`, `poststatus_changed`, `prevented_from_joining`, `reinvited_member`, `rejected_member`, `rejected_pending_message`, `removed_bluesky_integration`, `removed_email_integration`, `removed_facebook_integration`, `removed_github_integration`, `removed_hashtag`, `removed_instagram_integration`, `removed_invite`, `removed_member`, `removed_member_label`, `removed_rss_integration`, `removed_trello_integration`, `reopened_thread`, `reported_file`, `reported_message`, `reported_photo`, `resent_confirmation`, `resent_pending_member_notice`, `resumed_membership`, `rotated_photo`, `sent_bounce_probe`, `sent_message_accepted`, `sent_message_announcement`, `sent_message_announcement_password`, `sent_message_attachment_bounced`, `sent_message_banned`, `sent_message_bounced_sub`, `sent_message_cant_add_event`, `sent_message_cant_create_tags`, `sent_message_closed_topic`, `sent_message_mod_only_tags`, `sent_message_moderated`, `sent_message_no_tags`, `sent_message_not_allowed`, `sent_message_not_confirmed_sub`, `sent_message_not_subscriber`, `sent_message_pending_sub`, `sent_message_too_big`, `sent_to_owner`, `sig_changed`, `sig_changed_by_moderator`, `spam_left`, `spam_sent_to_owner`, `split_thread`, `sticky_thread`, `stripe_account_connected`, `stripe_account_disconnected`, `unbanned_member`, `unbounced_user`, `unlocked_event`, `unmoderated_thread`, `unsticky_thread`, `virus_bounced_member`, `virus_bounced_nonmember`, `virus_moderated_message`.
member_info Member Info object

Example Object

{
 "id": 76,
 "object": "past_member",
 "created": "2009-11-10T15:00:00-08:00",
 "action": "spamleft",
 "member_info": 
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   },
}

The Past Member List Object

The Past Member List object contains a list of Past Member objects.

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Past Member objects

Methods That Use This Object

Get Past Members	View Method

Example Object

{
 "object": "list",
 "total_count": 56,
 "start_item": 97,
 "end_item": 62,
 "has_more": false,
 "next_page_token": 65,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 81,
    "object": "past_member",
    "created": "2009-11-10T15:00:00-08:00",
    "action": "spamleft",
    "member_info": 
      {
         "id": 93846546,
         "object": "member_info",
         "created": "2020-09-09T04:11:00-07:00",
         "updated": "2022-06-08T07:16:00-07:00",
         "user_id": 147779411,
         "group_id": 8658933,
         "group_name": "StrategyHub",
         "status": "sub_status_normal",
         "post_status": "sub_poststatus_newusermoderated",
         "email_delivery": "email_delivery_digest",
         "message_selection": "message_selection_follow_and_first_message",
         "auto_follow_replies": false,
         "max_attachment_size": "max_attachment_size_medium",
         "approved_posts": 0,
         "mod_status": "sub_modstatus_owner",
         "pending_msg_notify": "sub_notify_email_and_app",
         "pending_sub_notify": "sub_notify_email_and_app",
         "sub_notify": "sub_notify_email_and_app",
         "storage_notify": "sub_notify_email_and_app",
         "sub_group_notify": "sub_notify_email_and_app",
         "message_report_notify": "sub_notify_email_and_app",
         "account_notify": "sub_notify_email_and_app",
         "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
         "owner_msg_notify": "sub_ownermsg_notify_subs",
         "chat_notify": "sub_notify_email_and_app",
         "photo_notify": "sub_notify_email_and_app",
         "file_notify": "sub_notify_email_and_app",
         "wiki_notify": "sub_notify_email_and_app",
         "database_notify": "sub_notify_email_and_app",
         "email": "gersonbeahan@jacobi.io",
         "user_status": "user_status_confirmed",
         "user_name": "Dickens6041",
         "timezone": "America/Chicago",
         "full_name": "Lawson Kreiger",
         "about_me": "Today awfully arrive at",
         "location": "Well away onto",
         "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "profile_privacy": "profile_private",
         "dont_munge_message_id": false,
         "use_signature": false,
         "use_signature_email": false,
         "signature": "In hotel furniture anyone weakly besides",
         "color": "color_cerulean_blue",
         "cover_photo_url": "",
         "icon_url": "",
         "nice_group_name": "",
         "subs_count": 0,
         "most_recent_message": "0001-01-01T00:00:00Z",
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "member_labels": [
           {
             "id": 726,
             "object": "memberlabel",
             "created": "2020-09-29T22:19:00Z",
             "group_id": 1857,
             "name": "Florida",
             "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
             "color_name": "green-sage",
             "color_hex": "#9fc4ac"
           },
           {
             "id": 1594,
             "object": "memberlabel",
             "created": "2020-09-24T02:24:00Z",
             "group_id": 42,
             "name": "Russel",
             "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
             "color_name": "purple",
             "color_hex": "#837fd5"
           },
           {
             "id": 1189,
             "object": "memberlabel",
             "created": "2020-09-12T02:11:00Z",
             "group_id": 1474,
             "name": "Meta",
             "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
             "color_name": "sky",
             "color_hex": "#9cc7df"
           }
         ],
         "extra_member_data": [
           {
             "col_id": 48876437,
             "col_type": "text_column",
             "text": "To firstly unlock while host himself me purely as whose."
           },
           {
             "col_id": 161476183,
             "col_type": "paragraph_column",
             "text": "Yet few mustering example will addition yearly since in these."
           },
           {
             "col_id": 39354277,
             "col_type": "checkbox_column",
             "checked": false
           },
           {
             "col_id": 8897324,
             "col_type": "multiple_choice_column",
             "multi_choice": [
               0
             ]
           },
           {
             "col_id": 159828550,
             "col_type": "date_column",
             "date": "1916-10-16T17:57:55.797000001Z"
           },
           {
             "col_id": 185149472,
             "col_type": "time_column",
             "time": "1919-03-30T18:00:36.790929649Z"
           },
           {
             "col_id": 166814414,
             "col_type": "address_column",
             "street_address1": "Premier Medical Group",
             "street_address2": "3701 DAUPHIN ST",
             "city": "MOBILE",
             "state": "AL",
             "zip": "36608-1756",
             "lat": 30.6866076,
             "lng": -88.13019249999999
           },
           {
             "col_id": 102385421,
             "col_type": "multi_choice_column",
             "multi_choice": [
               0,
               1,
               2
             ]
           },
           {
             "col_id": 154317202,
             "col_type": "link_column",
             "title": "To say poorly out according abundant unless nervously string lastly.",
             "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
             "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
           },
           {
             "col_id": 123191768,
             "col_type": "image_column",
             "url": "https://picsum.photos/id/27/187/110",
             "image_name": "Lately blazer with wild hourly there she it infrequently power."
           },
           {
             "col_id": 53386358,
             "col_type": "html_paragraph_column",
             "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
           },
           {
             "col_id": 45812071,
             "col_type": "email_column",
             "text": "brantkozey@bernhard.com"
           }
         ]
      },
   }
 ],
}

The Pending Message Object

The pending message object.

Response Attributes

object string	pending_message.
id number	ID of the pending message object, referenced in results.
created date	Time pending message was received.
updated date	Time of last update to the pending message.
group_id number	ID of the group.
user_id number	ID of the user.
subject string	Message subject.
is_special boolean	True if this is a special message.
is_web_post boolean	If the message was posted from the web.
has_attachments boolean	True if the message has attachments.
editor_member_id number	Member ID of the person who edited this message if this is an edit.
raw_message string	The message body, in HTML format.
message_body string	Decoded message body.
body_format string	Message body format.
sender optional Profile Data object	Subscriber who sent the message, may be excluded if a non-subscriber.
sender_email string	Email of the sender, use if sender is not available.
sender_name string	Name of the sender, use if sender is not available.
claiming_user optional Profile Data object	Moderator who has claimed the message.
claimed_date date	When the moderator claimed the message.
editor optional Profile Data object	Moderator who has edited the message, may be excluded if the message hasn't been edited.
edit_reason string	The reason given by the editor for the edit.
type string	Pending message type.
virus_name string	If this message is moderated because of a virus, this is the name of the virus.

Example Object

{
 "object": "pending_message",
 "id": 64,
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "group_id": 22,
 "user_id": 41,
 "subject": "",
 "is_special": false,
 "is_web_post": false,
 "has_attachments": false,
 "editor_member_id": 0,
 "raw_message": "",
 "message_body": "",
 "body_format": "",
 "sender": 
   {
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "name": "Lawson Kreiger",
      "can_view_profile": false
   },
 "sender_email": "",
 "sender_name": "",
 "claiming_user": 
   {
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "name": "Lawson Kreiger",
      "can_view_profile": false
   },
 "claimed_date": "2009-11-10T15:00:00-08:00",
 "editor": 
   {
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "name": "Lawson Kreiger",
      "can_view_profile": false
   },
 "edit_reason": "",
 "type": "",
 "virus_name": "",
}

The Pending Message List Object

Pending Message List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Pending Message objects

Methods That Use This Object

Get Pending Messages	View Method

Example Object

{
 "object": "list",
 "total_count": 90,
 "start_item": 29,
 "end_item": 22,
 "has_more": false,
 "next_page_token": 36,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "object": "pending_message",
    "id": 83,
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "group_id": 0,
    "user_id": 0,
    "subject": "",
    "is_special": false,
    "is_web_post": false,
    "has_attachments": false,
    "editor_member_id": 78,
    "raw_message": "",
    "message_body": "",
    "body_format": "",
    "sender": 
      {
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "name": "Lawson Kreiger",
         "can_view_profile": false
      },
    "sender_email": "",
    "sender_name": "",
    "claiming_user": 
      {
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "name": "Lawson Kreiger",
         "can_view_profile": false
      },
    "claimed_date": "2009-11-10T15:00:00-08:00",
    "editor": 
      {
         "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
         "name": "Lawson Kreiger",
         "can_view_profile": false
      },
    "edit_reason": "",
    "type": "",
    "virus_name": "",
   }
 ],
}

The Pending Message Result Object

Pending Message Result

Response Attributes

id number	ID of the pending message.
result string	Result of the operation on this message.

Example Object

{
 "id": 95,
 "result": "",
}

The Pending Message Results List Object

Pending Message Results List

Response Attributes

data array of Pending Message Result objects

Example Object

{
 "data": [
   {
    "id": 79,
    "result": "",
   }
 ],
}

The Perms Object

Perms lists all possible Groups.io permissions, and which ones a particular subscription has. There are two 'sets' of things in the permissions object. One set is a more fine grain set of permissions, which describe what actions a subscriber can do. And the second are the _visible flags, which tell you whether a specific area of the group is visible at all. There is some duplication between the two sets.

Response Attributes

object string	perms.
archives_visible boolean	If the group archives are visible.
polls_visible boolean	If the group polls are visible.
members_visible boolean	If the members page is visible.
chat_visible boolean	If the chat section is visible.
calendar_visible boolean	If the calendar is visible.
files_visible boolean	If the files section is visible.
database_visible boolean	If the database is visible.
photos_visible boolean	If the photos section is visible.
wiki_visible boolean	If the wiki is visible.
member_directory_visible boolean	If the member directory is visible.
hashtags_visible boolean	If the Hashtags section is visible.
guidelines_visible boolean	Does the user have permission to view the group guidelines.
subgroups_visible boolean	If the subgroups page is visible.
open_donations_visible boolean	If the open donations page is visible.
sponsor_visible boolean	If the group sponsor page is visible.
manage_subgroups boolean	Does the user have permission to create and manage subgroups.
ask_visible boolean	If the ask responses are visible.
delete_group boolean	Does the user have permission to delete the group.
download_archives boolean	Does the user have permission to download the group message archives.
download_entire_group boolean	Does the user have permission to download all aspects of the group.
download_members boolean	Does the user have permission to download the member list.
view_activity boolean	Does the user have permission to view the activity log.
create_hashtags boolean	Does the user have permission to create hashtags.
manage_hashtags boolean	Does the user have permission to edit and delete hashtags.
manage_integrations boolean	Does the user have permission to manage group integrations, including Github, Trello, Facebook, RSS and Email integrations.
manage_group_settings boolean	Does the user have permission to change group settings, including member notices and cover photos.
make_moderator boolean	Does the user have permission to make another member a moderator.
manage_member_subscription_options boolean	Does the user have permission to change other members' subscription options.
manage_pending_members boolean	Does the user have permission to manage pending member subscriptions.
remove_members boolean	Does the user have permission to remove members from the group.
ban_members boolean	Does the user have permission to ban members from the group.
manage_group_billing boolean	Does the user have permission to make changes to group billing, including upgrading the group, paying for the upgrade, and viewing invoices.
manage_group_payments boolean	Does the user have permission to manage group payments, including setting up donations.
edit_archives boolean	Does the user have permission to edit group messages, including merging topics.
manage_pending_messages boolean	Does the user have permission to approve, deny and reject pending messages.
invite_members boolean	Does the user have permission to invite people to join the group, and for premium groups, to directly add people to the group.
can_post boolean	Does the user have permission to post messages to the group.
can_reply boolean	Does the user have permission to reply to messages in the group (only different from CanPost for GroupReplyToGroupID groups).
can_vote boolean	Does the user have permission to vote on polls.
manage_polls boolean	Does the user have permission to add or edit polls. The user must have posting privileges, otherwise this will be false.
manage_photos boolean	Does the user have permission to create photo albums and upload photos.
manage_members boolean	This is true if any of: `make_moderator`, `remove_members`, `ban_members`, `make_moderator`, `manage_member_subscription_options` are true.
manage_calendar boolean	Does the user have permission to add or edit calendar events.
manage_chats boolean	Does the user have permission to create chats.
view_member_directory boolean	Does the user have permission to view the member directory.
manage_files boolean	Does the user have permission to upload and edit files and folders.
manage_wiki boolean	Does the user have permission to add or edit wiki pages.
manage_subscription boolean	Does the user have permission to edit their subscription.
public_page boolean
sub_page boolean
mod_page boolean
can_ask boolean	Does the user have permission to ask questions.

Methods That Use This Object

Get Permissions	View Method

Example Object

{
   "object": "perms",
   "archives_visible": true,
   "polls_visible": true,
   "members_visible": true,
   "chat_visible": true,
   "calendar_visible": true,
   "files_visible": true,
   "database_visible": true,
   "photos_visible": true,
   "wiki_visible": true,
   "member_directory_visible": true,
   "hashtags_visible": true,
   "guidelines_visible": true,
   "subgroups_visible": true,
   "open_donations_visible": true,
   "sponsor_visible": true,
   "manage_subgroups": true,
   "ask_visible": true,
   "delete_group": true,
   "download_archives": true,
   "download_entire_group": true,
   "download_members": true,
   "view_activity": true,
   "create_hashtags": true,
   "manage_hashtags": true,
   "manage_integrations": true,
   "manage_group_settings": true,
   "make_moderator": true,
   "manage_member_subscription_options": true,
   "manage_pending_members": true,
   "remove_members": true,
   "ban_members": true,
   "manage_group_billing": true,
   "manage_group_payments": true,
   "edit_archives": true,
   "manage_pending_messages": true,
   "invite_members": true,
   "can_post": true,
   "can_reply": true,
   "can_vote": true,
   "manage_polls": true,
   "manage_photos": true,
   "manage_members": true,
   "manage_calendar": true,
   "manage_chats": true,
   "view_member_directory": true,
   "manage_files": true,
   "manage_wiki": true,
   "manage_subscription": true,
   "public_page": true,
   "sub_page": true,
   "mod_page": true,
   "can_ask": true
}

The Photo Object

The photo object.

Response Attributes

id number	Unique ID of the photo object.
object string	photo.
created date
updated date
user_id number
group_id number
name string
desc string
media_type string
size number
attachment_num number	If this photo was sent as an attachment, this is the attachment number.
width number
height number
album_id number
display_name string	Name of the person who uploaded the photo.
user_name string	User name of the person who uploaded the photo.
profile_photo_url optional string	URL of the profile photo of the person who uploaded the photo.
profile_privacy string	Privacy setting of the person who uploaded the photo.
email string	Possibly obscured, depending on group settings.
format string	Type of image (jpeg, gif, png).
focal_length number	Focal Length, in mm.
iso number	ISO.
aperture number	Aperture, as in f/aperture.
shutter_speed number	Shutter speed, in 1/shutterspeed seconds.
taken number	Time Taken, in Unix seconds since epoch.
make string	Camera make and model.
model string
thumbnail_url optional string
download_url optional string

Methods That Use This Object

Get Photo	View Method

Example Object

{
   "id": 960,
   "object": "photo",
   "created": "2020-09-06T23:48:00-07:00",
   "updated": "2022-03-08T08:06:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "name": "Elegance joy group",
   "desc": "Senegalese whichever happen trade move outside downstairs of exemplified up. Out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for. Her our much nevertheless which numerous alone bevy as by. From e.g. otherwise laptop cloud then them yourselves few look.",
   "media_type": "image/jpg",
   "size": 2390440,
   "attachment_num": 0,
   "width": 0,
   "height": 0,
   "album_id": 52691321,
   "display_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "profile_privacy": "profile_private",
   "email": "gersonbeahan@...",
   "format": "jpeg",
   "focal_length": 0,
   "iso": 0,
   "aperture": 0,
   "shutter_speed": 0,
   "taken": 0,
   "make": "",
   "model": ""
}

The Photo List Object

Photo List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
album optional Album object	In the case of search results, the Album data is not included.
data array of Photo objects

Methods That Use This Object

Add Photos	View Method
Get Photos	View Method
Search Photos	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 1253,
       "object": "photo",
       "created": "2020-08-30T23:30:00-07:00",
       "updated": "2023-04-23T17:44:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Store elegance joy group Senegalese",
       "desc": "Whichever happen trade move outside downstairs of exemplified up out. Destroy due taste anything where this that would whom to. Cautiously till only himself fight our whomever that for her. Our much nevertheless which numerous alone bevy as by from. E.g. otherwise laptop cloud then them yourselves few look fleet.",
       "media_type": "image/jpg",
       "size": 9234415,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 52691321,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 777,
       "object": "photo",
       "created": "2020-09-23T03:05:00-07:00",
       "updated": "2022-11-16T21:00:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "As yesterday we inquire",
       "desc": "Ourselves his laugh string several accordingly kindness bit stand woman. Just poised they enough thing homework each clothing other cry. Obediently refill do differs yearly those woman pen today as. Now ourselves first for without what might any where as. Out me were Norwegian significant his do mob notice lastly.",
       "media_type": "image/jpg",
       "size": 5695695,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 127437101,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     },
     {
       "id": 1620,
       "object": "photo",
       "created": "2020-09-26T00:12:00-07:00",
       "updated": "2023-03-26T20:23:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "name": "Then result these preen numerous on",
       "desc": "Frequently him at tonight is seriously why kiss logic beyond. Him swing our Amazonian will for myself everybody I abundant. Few weekly anyone an weekly someone being that her enthusiasm. Yours never without theirs mine that delay that the air. Whatever bundle you is such batch accommodation without now in.",
       "media_type": "image/jpg",
       "size": 8923756,
       "attachment_num": 0,
       "width": 0,
       "height": 0,
       "album_id": 7850581,
       "display_name": "Lawson Kreiger",
       "user_name": "Dickens6041",
       "profile_privacy": "profile_private",
       "email": "gersonbeahan@...",
       "format": "jpeg",
       "focal_length": 0,
       "iso": 0,
       "aperture": 0,
       "shutter_speed": 0,
       "taken": 0,
       "make": "",
       "model": ""
     }
   ]
}

The Poll Object

The poll object.

Response Attributes

id number	Unique ID of the poll object.
object string	poll.
created date
updated date
user_id number	ID of the person who created the poll.
group_id number	ID of the group.
profile_photo_url string	If not empty then there is a profile photo associated with this votor.
name string	Name of the person who voted.
can_view_profile boolean	If the person viewing this poll can view the profile.
question string	Title of poll.
desc string	Description, in HTML.
multiple boolean	If false, only can select one choice.
results_at_end boolean	if true, only display the results at poll close.
never_show_results boolean	if true, members can never see the results (overrides results_at_end).
can_view_results boolean	If you have permission to view the results.
answers optional array of Poll Answer objects	The possible answers.
results optional array of Poll Result objects	Results.
is_closed boolean	if the poll is closed.
msg_num number	Message number of the Message we're associated with. If 0, means the poll hasn't been approved/sent yet.
anonymous boolean	If you cannot see who responded.

Methods That Use This Object

New Poll	View Method
Update Poll	View Method
Get Poll	View Method

Example Object

{
 "id": 94,
 "object": "poll",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 30,
 "group_id": 67,
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
 "question": "",
 "desc": "",
 "multiple": false,
 "results_at_end": false,
 "never_show_results": false,
 "can_view_results": false,
 "answers": [
   {
    "answer": "",
    "selected": false,
   }
 ],
 "results": [
   {
    "answer": "",
    "count": 53,
    "percentage": "",
    "votes": [
      {
       "user_id": 35,
       "email": "",
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
      }
    ],
   }
 ],
 "is_closed": false,
 "msg_num": 96,
 "anonymous": false,
}

The Poll Answer Object

The poll answer object.

Response Attributes

answer string	Possible answer.
selected boolean	If we selected this answer.

Example Object

{
 "answer": "",
 "selected": false,
}

The Poll Result Object

The poll result object.

Response Attributes

answer string	The answer.
count number	How many people voted for this answer.
percentage string	The percentage of total votes for this answer.
votes optional array of Poll Vote objects	All votes for this answer, if we have permission to view them.

Example Object

{
 "answer": "",
 "count": 10,
 "percentage": "",
 "votes": [
   {
    "user_id": 59,
    "email": "",
    "profile_photo_url": "",
    "name": "",
    "can_view_profile": false,
   }
 ],
}

The Poll Results Object

The poll results object.

Response Attributes

poll_id number	Unique ID of the poll object.
object string	poll_results.
results array of Poll Result objects	Results.

Methods That Use This Object

Get Poll Results	View Method

Example Object

{
 "poll_id": 61,
 "object": "poll_results",
 "results": [
   {
    "answer": "",
    "count": 40,
    "percentage": "",
    "votes": [
      {
       "user_id": 79,
       "email": "",
       "profile_photo_url": "",
       "name": "",
       "can_view_profile": false,
      }
    ],
   }
 ],
}

The Poll Vote Object

The poll vote object. Represents a single vote in a poll.

Response Attributes

user_id number	User ID of the voter.
email string	Email of the voter.
profile_photo_url string	If not empty then there is a profile photo associated with this votor.
name string	Name of the person who voted.
can_view_profile boolean	If the person viewing this poll can view the profile.

Example Object

{
 "user_id": 61,
 "email": "",
 "profile_photo_url": "",
 "name": "",
 "can_view_profile": false,
}

The Profile Data Object

The profile data object.

Response Attributes

profile_photo_url string	If not empty then there is a profile photo associated with this votor.
name string	Name of the person who voted.
can_view_profile boolean	If the person viewing this poll can view the profile.

Example Object

{
   "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
   "name": "Lawson Kreiger",
   "can_view_profile": false
}

The Push Sub Object

The push subscription object.

Response Attributes

id number	Unique ID of the push sub object.
object string	push_sub.
created date
updated date
user_id number	ID of the person who is subscribed.
type string	Type of push subscription. Can be one of: `mobile_push_sub`, `no_push_sub`, `web_push_sub`.
os string	Operating System associated with the push subscription.
browser string	Browser associated with the push subscription, not set if this is a device push subscription. Can be one of: `app`, `chrome`, `chromium`, `crawler`, `edge`, `firefox`, `msie`, `opera`, `safari`, `unknown_browser`.
p256dh string	for web push subs.
auth string	for web push subs.
endpoint string	for web push subs, is the token for mobile push subs.

Example Object

{
 "id": 63,
 "object": "push_sub",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 40,
 "type": "mobile_push_sub",
 "os": "",
 "browser": "app",
 "p256dh": "",
 "auth": "",
 "endpoint": "",
}

The Push Sub List Object

Push Sub List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Push Sub objects

Methods That Use This Object

Get Push Subs	View Method

Example Object

{
 "object": "list",
 "total_count": 79,
 "start_item": 75,
 "end_item": 55,
 "has_more": false,
 "next_page_token": 69,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 55,
    "object": "push_sub",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 22,
    "type": "mobile_push_sub",
    "os": "",
    "browser": "app",
    "p256dh": "",
    "auth": "",
    "endpoint": "",
   }
 ],
}

The RSVP Object

The rsvp object.

Response Attributes

id number	Unique ID of the rsvp object.
object string	rsvp.
created date	The time that this object was created.
updated date	The time that this object was last updated.
event_id number	The ID of the associated event object.
group_id number	The ID of the associated group.
user_id number	The ID of the person who created this rsvp.
user_name string	The user_name of the person who created this rsvp.
full_name string	The full_name of the person who created this rsvp.
email string	The email address of the person who created this rsvp.
profile_photo_url string
type string	The type of RSVP. Can be one of: `rsvp_maybe`, `rsvp_no`, `rsvp_waitlist`, `rsvp_yes`.
comment string	Some events ask a question of people rsvp'ing. This is that answer.
additional_guests number	Some events allow additional guests.

Methods That Use This Object

RSVP To An Event	View Method

Example Object

{
 "id": 78,
 "object": "rsvp",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "event_id": 44,
 "group_id": 54,
 "user_id": 99,
 "user_name": "",
 "full_name": "",
 "email": "",
 "profile_photo_url": "",
 "type": "rsvp_maybe",
 "comment": "",
 "additional_guests": 17,
}

The Sub Group And Category Object

The sub group and category object.

Response Attributes

category Sub Group Category object
group Group object

Example Object

{
 "category": 
   {
    "id": 15,
    "object": "sub_group_category",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "parent_group_id": 40,
    "name": "example",
    "desc": "",
    "max_subs": 40,
    "order": 98,
   },
 "group": 
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   },
}

The Sub Group Category Object

The sub group category object.

Response Attributes

id number
object string	sub_group_category.
created date
updated date
parent_group_id number
name string	Name.
desc string	Description, in HTML format.
max_subs number	Max number of subscribers allowed per group.
order number	Used in sort.

Example Object

{
 "id": 2,
 "object": "sub_group_category",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "parent_group_id": 56,
 "name": "example",
 "desc": "",
 "max_subs": 29,
 "order": 81,
}

The Sub Group Category List Object

Sub Group Category List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Sub Group Category objects

Methods That Use This Object

Get Sub Group Categories	View Method

Example Object

{
 "object": "list",
 "total_count": 9,
 "start_item": 98,
 "end_item": 83,
 "has_more": false,
 "next_page_token": 38,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "data": [
   {
    "id": 54,
    "object": "sub_group_category",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "parent_group_id": 95,
    "name": "example",
    "desc": "",
    "max_subs": 66,
    "order": 41,
   }
 ],
}

The Sub Groups By Category Object

The sub groups by categories object.

Response Attributes

subscribed array of Sub Group And Category objects	Subgroups you are subscribed to.
uncategorized array of Group objects	Uncategorized subgroups you are not subscribed to.
by_category array of Sub Group And Category objects	Categorized subgroups you are not subscribed to.

Methods That Use This Object

Get Sub Groups By Category	View Method

Example Object

{
 "subscribed": [
   {
    "category": 
      {
       "id": 88,
       "object": "sub_group_category",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "parent_group_id": 67,
       "name": "example",
       "desc": "",
       "max_subs": 68,
       "order": 31,
      },
    "group": 
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      },
   }
 ],
 "uncategorized": [
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   }
 ],
 "by_category": [
   {
    "category": 
      {
       "id": 37,
       "object": "sub_group_category",
       "created": "2009-11-10T15:00:00-08:00",
       "updated": "2009-11-10T15:00:00-08:00",
       "parent_group_id": 50,
       "name": "example",
       "desc": "",
       "max_subs": 21,
       "order": 26,
      },
    "group": 
      {
         "id": 8658933,
         "object": "group",
         "created": "2020-09-15T11:29:00-07:00",
         "updated": "2022-02-12T18:51:00-08:00",
         "type": "group_type_messages",
         "title": "",
         "name": "StrategyHub",
         "nice_group_name": "",
         "alias": "",
         "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
         "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
         "subject_tag": "[StrategyHub]",
         "footer": "This is my\nFooter!!!!",
         "website": "",
         "announce": false,
         "moderation": "moderated",
         "new_users_moderated": true,
         "unmoderate_users_after": 3,
         "restricted": true,
         "invite_only": false,
         "allow_non_subs_to_post": false,
         "force_html_emails": false,
         "normalize_html_emails": false,
         "reply_to": "group_reply_to_group",
         "remove_other_reply_options": false,
         "privacy": "group_privacy_none",
         "seperate_footers": false,
         "allow_downloads": "allow_downloads_by_members",
         "members_visible": "group_view_members_moderators",
         "sub_group_access": "sub_group_subs",
         "calendar_access": "group_access_subscribers",
         "files_access": "group_access_subscribers",
         "database_access": "group_access_subscribers",
         "wiki_access": "group_access_subscribers",
         "photos_access": "group_access_subscribers",
         "member_directory_access": "group_access_subscribers",
         "polls_access": "polls_access_subscribers",
         "chat_access": "group_access_subscribers",
         "handle_attachments": "group_attachments_normal",
         "plain_text_only": false,
         "handle_virus": "handle_virus_block",
         "locked": false,
         "plan": "group_plan_premium",
         "trial_group": false,
         "has_cover_photo": false,
         "has_icon": false,
         "parent_group_id": 0,
         "org_id": 1,
         "max_photo_size_email": "max_photo_size_none",
         "max_photo_size_photos": "max_photo_size_none",
         "max_photo_size_databases": "max_photo_size_none",
         "max_photo_size_wiki_images": "max_photo_size_none",
         "hash_tags_required": false,
         "hash_tag_permissions": "hash_tag_create_subs",
         "bounce_attachments": false,
         "allow_photos_in_files": false,
         "allow_reposts": false,
         "min_days_between_reposts": 0,
         "max_number_of_reposts": 0,
         "email_delivery_default": "email_delivery_single",
         "message_selection_default": "message_selection_all",
         "auto_follow_replies_default": false,
         "max_attachment_size_default": "max_attachment_size_small",
         "default_color": "color_cerulean_blue",
         "default_timezone": "America/Los_Angeles",
         "default_time_pref": "standard_time",
         "default_date_pref": "us_date",
         "default_monday_start": false,
         "disable_edits": false,
         "disable_no_email": false,
         "auto_close_threads": false,
         "close_threads_after": 0,
         "auto_moderate_threads": false,
         "moderate_threads_after": 0,
         "sticky_wiki_page_id": 0,
         "sub_group_categoryid": 0,
         "subs_count": 541,
         "pending_subs_count": 0,
         "pending_msgs_count": 0,
         "open_chats_count": 0,
         "threads_count": 0,
         "messages_count": 0,
         "org_domain": "",
         "most_recent_message": "2020-09-07T19:38:00-07:00",
         "cover_photo_url": "",
         "icon_url": "",
         "group_url": "",
         "allow_parent_subs_to_post": false,
         "send_event_summaries": false,
         "event_summary_schedule": "event_summary_weekly_friday",
         "send_invites_on_join": false,
         "perms": {
           "object": "perms",
           "archives_visible": true,
           "polls_visible": true,
           "members_visible": true,
           "chat_visible": true,
           "calendar_visible": true,
           "files_visible": true,
           "database_visible": true,
           "photos_visible": true,
           "wiki_visible": true,
           "member_directory_visible": true,
           "hashtags_visible": true,
           "guidelines_visible": true,
           "subgroups_visible": true,
           "open_donations_visible": true,
           "sponsor_visible": true,
           "manage_subgroups": true,
           "ask_visible": true,
           "delete_group": true,
           "download_archives": true,
           "download_entire_group": true,
           "download_members": true,
           "view_activity": true,
           "create_hashtags": true,
           "manage_hashtags": true,
           "manage_integrations": true,
           "manage_group_settings": true,
           "make_moderator": true,
           "manage_member_subscription_options": true,
           "manage_pending_members": true,
           "remove_members": true,
           "ban_members": true,
           "manage_group_billing": true,
           "manage_group_payments": true,
           "edit_archives": true,
           "manage_pending_messages": true,
           "invite_members": true,
           "can_post": true,
           "can_reply": true,
           "can_vote": true,
           "manage_polls": true,
           "manage_photos": true,
           "manage_members": true,
           "manage_calendar": true,
           "manage_chats": true,
           "view_member_directory": true,
           "manage_files": true,
           "manage_wiki": true,
           "manage_subscription": true,
           "public_page": true,
           "sub_page": true,
           "mod_page": true,
           "can_ask": true
         },
         "email_address": "StrategyHub@groups.io",
         "extra_member_data_columns": [
           {
             "id": 48876437,
             "name": "Text: Lots write point week doctor.",
             "type": "text_column",
             "required": true,
             "color": "color_beige",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Movement whose also it vanish watch these to ever always."
           },
           {
             "id": 161476183,
             "name": "Paragraph: Other few covey range window.",
             "type": "paragraph_column",
             "required": true,
             "color": "color_light_brown",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Silence lastly had what outcome let while school pause up."
           },
           {
             "id": 39354277,
             "name": "Checkbox: Company freedom pout his throw.",
             "type": "checkbox_column",
             "required": true,
             "color": "color_orange",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Quarterly outfit faithful is often part whom these been hourly."
           },
           {
             "id": 8897324,
             "name": "Multiple Choice: Madagascan anyway should late yours.",
             "type": "multiple_choice_column",
             "required": true,
             "color": "color_orchid",
             "choices": [
               "Monthly ball upon almost everything dynasty.",
               "Behalf shall nearly this weekly for.",
               "Anywhere everybody over secondly then boat."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Besides pack when murder her had snore first in limp."
           },
           {
             "id": 159828550,
             "name": "Date: Which these bale nobody few.",
             "type": "date_column",
             "required": true,
             "color": "color_blush",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "How anyone these string life that who result lately yourselves."
           },
           {
             "id": 185149472,
             "name": "Time: Besides later whom for rarely.",
             "type": "time_column",
             "required": true,
             "color": "color_sage",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Each her ski ours host our as did they to."
           },
           {
             "id": 166814414,
             "name": "Address: Bravery where this as cloud.",
             "type": "address_column",
             "required": true,
             "color": "color_cucumber",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Inside since open most you that including fight murder cautiously."
           },
           {
             "id": 102385421,
             "name": "Multi Choice: Another what full her can.",
             "type": "multi_choice_column",
             "required": true,
             "color": "color_aquamute",
             "choices": [
               "Indeed besides motherhood in that nightly.",
               "Limit we kneel herself collect yourselves.",
               "Yourselves Norwegian this fear happily fruit."
             ],
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Pout nature bike moreover from whoever afterwards myself mine to."
           },
           {
             "id": 154317202,
             "name": "Link: Bale sedge Christian would whose.",
             "type": "link_column",
             "required": true,
             "color": "color_military",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Hers pack rhythm that now whose her out infancy somebody."
           },
           {
             "id": 123191768,
             "name": "Image: Today scenic consequently ours eye.",
             "type": "image_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Other other abundant some anywhere this life nevertheless in next."
           },
           {
             "id": 53386358,
             "name": "HTML Paragraph: Nobody what today e.g. loss.",
             "type": "html_paragraph_column",
             "required": true,
             "color": "color_emerald_green",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Spite Philippine before throughout wander of as there next of."
           },
           {
             "id": 45812071,
             "name": "Email: That because am terribly many.",
             "type": "email_column",
             "required": true,
             "color": "color_light_grey",
             "width": 0,
             "default_hidden": false,
             "profile": false,
             "description": "Because anyone does you hungrily can several might who monthly."
           }
         ]
      },
   }
 ],
}

The Success Object

The success object.

Response Attributes

object string	success.
extra string

Methods That Use This Object

Update Event	View Method
Delete Event	View Method
Update Repeat Event	View Method
Delete Repeat Event	View Method

Example Object

{
 "object": "success",
 "extra": "",
}

The Topic Object

The topic object.

Response Attributes

id number
object string	topic.
created date
updated date
group_id number
group_subject_tag string
subject string	Subject of the topic.
summary string	Summary of the first message in the topic.
name string	Name of the originator of the topic.
profile_photo_url string	If not empty then there is a profile photo associated with this author.
num_messages number	Number of messages in the topic.
is_sticky boolean	If the topic is sticky.
is_moderated boolean	If the topic is moderated.
is_closed boolean	If the topic is closed.
has_attachments boolean	If the topic has at least one message that has attachments.
reply_to string	Can be one of: `thread_reply_group_default`, `thread_reply_only_to_sender`, `thread_reply_to_followers_only`, `thread_reply_to_group`, `thread_reply_to_group_and_sender`, `thread_reply_to_moderators`, `thread_reply_to_sender`.
most_recent_message date	Date of the most recent message in the topic.
hashtags array of Hashtag objects

Example Object

{
   "id": 52691321,
   "object": "topic",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "group_id": 8658933,
   "group_subject_tag": "[StrategyHub]",
   "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
   "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
   "name": "Elenor Schaefer",
   "profile_photo_url": "",
   "num_messages": 22,
   "is_sticky": false,
   "is_moderated": false,
   "is_closed": false,
   "has_attachments": false,
   "reply_to": "thread_reply_group_default",
   "most_recent_message": "2020-09-29T17:03:00-07:00",
   "hashtags": null
}

The Topic List Object

Topic List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
group_perms optional Perms object
group optional Group object
sub_data optional array of Member Info objects
data array of Topic objects

Methods That Use This Object

Get Topics	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "topic",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "group_id": 8658933,
       "group_subject_tag": "[StrategyHub]",
       "subject": "Anyway what quickly abundant respect pyramid accordingly onto moreover whenever e.g. fear.",
       "summary": "Usually body kilometer nightly child so firstly he next each. Secondly must catch politely sleepy where i.e. inquisitively yours wisp. Regularly nice cackle ourselves heavily now this our yearly what. Few why where win most would everybody them backwards this. That provided store elegance joy group Senegalese whichever happen trade.",
       "name": "Elenor Schaefer",
       "profile_photo_url": "",
       "num_messages": 10,
       "is_sticky": false,
       "is_moderated": false,
       "is_closed": false,
       "has_attachments": false,
       "reply_to": "thread_reply_group_default",
       "most_recent_message": "2020-09-13T23:35:00-07:00",
       "hashtags": null
     },
     {
       "id": 40360814,
       "object": "topic",
       "created": "2020-08-30T21:35:00-07:00",
       "updated": "2023-05-02T01:56:00-07:00",
       "group_id": 8658933,
       "group_subject_tag": "[StrategyHub]",
       "subject": "Some instance inquire ourselves his laugh string several accordingly kindness bit stand.",
       "summary": "Woman just poised they enough thing homework each clothing other. Cry obediently refill do differs yearly those woman pen today. As now ourselves first for without what might any where. As out me were Norwegian significant his do mob notice. Lastly theirs hotel one calm that later does point throw.",
       "name": "Albina Bernhard",
       "profile_photo_url": "",
       "num_messages": 29,
       "is_sticky": false,
       "is_moderated": false,
       "is_closed": false,
       "has_attachments": false,
       "reply_to": "thread_reply_group_default",
       "most_recent_message": "2020-09-08T16:42:00-07:00",
       "hashtags": null
     },
     {
       "id": 135780324,
       "object": "topic",
       "created": "2020-09-24T13:22:00-07:00",
       "updated": "2022-10-24T22:40:00-07:00",
       "group_id": 8658933,
       "group_subject_tag": "[StrategyHub]",
       "subject": "For previously as of along nobody back hers numerous would our bra.",
       "summary": "Yours union Bangladeshi Bahamian now wiggle should our example eye. Woman in religion am collapse regiment in were choir troop. Speed throw year work let bunch one choir those horror. Would is so team disregard completely decidedly which exaltation decidedly. Think niche annoyance yesterday hence as him his this one.",
       "name": "Elmore Prosacco",
       "profile_photo_url": "",
       "num_messages": 29,
       "is_sticky": false,
       "is_moderated": false,
       "is_closed": false,
       "has_attachments": false,
       "reply_to": "thread_reply_group_default",
       "most_recent_message": "2020-09-15T14:17:00-07:00",
       "hashtags": null
     }
   ]
}

The User Object

The user object.

Response Attributes

id number
object string	user.
created date
updated date
email string
full_name string
user_name string
timezone string
status string	Can be one of: `user_status_bounced`, `user_status_bouncing`, `user_status_confirmed`, `user_status_failed_reverify`, `user_status_inactive`, `user_status_not_confirmed`.
profile_photo_url string
post_pref string
per_page_pref string
allow_facebook_login boolean
allow_google_login boolean
allow_sso_login boolean
csrf_token string
two_factor_enabled boolean
recovery_codes string
dont_munge_message_id boolean	If true, we do not replace the message-id on any messages you send to groups. Replacing the message-id is a way to force Gmail (and others) to display messages you send.
about_me string	Profile stuff.
about_format string
location string
website string
time_pref string
date_pref string
monday_start boolean
profile_privacy string	Who can see this profile.
default_message_view string	The view we go into when viewing messages. Can be one of: `expanded_message_view`, `message_view`, `polls_view`, `thread_view`.
topics_sort_dir string	Sort direction in threads view.
topic_sort_dir string	Sort direction when viewing an individual thread.
messages_sort_dir string	Sort direction in messages view.
expanded_messages_sort_dir string	Sort direction in expanded messages view.
search_sort string	SearchSort is the default sort of search results.
search_sort_dir string	Sort direction in search results (does not apply to RelevanceSort).
photos_order_by string	Sort direction in photos view (albums).
photos_sort_dir string
album_order_by string	Sort direction in photo album view.
album_sort_dir string
default_calendar_view string	Default calendar view.
default_hashtag_view string	Default hashtag view.
default_rsvp_view string	Default view when viewing rsvps to an event.
home_page string	Which home page to display. Can be one of: `home_page_calendar`, `home_page_chats`, `home_page_feed`, `home_page_groups`, `home_page_topics`.
subscriptions optional array of Member Info objects	All of our subscriptions.

Methods That Use This Object

Get User	View Method
Update User	View Method
Update Profile	View Method
Update Profile Photo	View Method
Delete Profile Photo	View Method

Example Object

{
   "id": 147779411,
   "object": "user",
   "created": "2020-09-01T08:47:00-07:00",
   "updated": "2022-03-01T17:18:00-08:00",
   "email": "gersonbeahan@jacobi.io",
   "full_name": "Lawson Kreiger",
   "user_name": "Dickens6041",
   "timezone": "America/Chicago",
   "status": "user_status_confirmed",
   "profile_photo_url": "",
   "post_pref": "user_postpref_html",
   "per_page_pref": "user_per_page_pref20",
   "allow_facebook_login": false,
   "allow_google_login": false,
   "allow_sso_login": false,
   "csrf_token": "84491575",
   "two_factor_enabled": false,
   "recovery_codes": "",
   "dont_munge_message_id": false,
   "about_me": "Today awfully arrive at",
   "about_format": "about_html",
   "location": "Well away onto",
   "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
   "time_pref": "standard_time",
   "date_pref": "us_date",
   "monday_start": false,
   "profile_privacy": "profile_private",
   "default_message_view": "thread_view",
   "topics_sort_dir": "sort_none",
   "topic_sort_dir": "sort_none",
   "messages_sort_dir": "sort_none",
   "expanded_messages_sort_dir": "sort_none",
   "search_sort": "relevance_sort",
   "search_sort_dir": "sort_none",
   "photos_order_by": "",
   "photos_sort_dir": "sort_none",
   "album_order_by": "",
   "album_sort_dir": "sort_none",
   "default_calendar_view": "cal_view_month",
   "default_hashtag_view": "view_grid",
   "default_rsvp_view": "view_grid",
   "home_page": "home_page_feed"
}

The Webhook Event Object

The webhook event object. This represents an action monitored by a webhook_subscription.

Response Attributes

id number	Unique ID for this webhook event.
object string	Type of object. Is set to `webhook_event`.
created date	The time this event happened.
webhook_id number	The ID of the webhook_subscription that triggered this event.
action string	What action took place. Can be one of: `joined`, `created_subgroup`, `deleted_subgroup`.
via string	Through what means the action took place. Can be one of: `via_api`, `via_app`, `via_email`, `via_robot`, `via_slacksync`, `via_support`, `via_web`.
group optional Group object	The group related to the action.
member_info optional Member Info object	The member who did the action. May be omitted.
modded_member_info optional Member Info object	For events on members, this is the member acted upon. May be omitted.
non_member_email optional string	For events involving a non-member, this is their email address.
msg_num optional number	For events that involve a message, this is the message number.
subject optional string	For events that involve a message, this is the subject of the message.
message optional string	For events that involve a message, specifically `edited_message`, `sent_message_accepted`, `sent_message_moderated`, this is the raw message.
extra optional string	For events that require an extra string.
extra2 optional string	For events that require a second extra string.
extra_id optional number	For events that require an identifier.
extended_data optional string	For events that require extended data, in JSON format.

Example Object

{
 "id": 94,
 "object": "webhook_event",
 "created": "2009-11-10T15:00:00-08:00",
 "webhook_id": 96,
 "action": "created_group",
 "via": "via_web",
 "group": 
   {
      "id": 8658933,
      "object": "group",
      "created": "2020-09-15T11:29:00-07:00",
      "updated": "2022-02-12T18:51:00-08:00",
      "type": "group_type_messages",
      "title": "",
      "name": "StrategyHub",
      "nice_group_name": "",
      "alias": "",
      "desc": "\u003cdiv\u003eEye some contrast \u003cb\u003eas\u003c/b\u003e width yourself stand are woman over. Additionally \u003cb\u003eCosta\u003c/b\u003e that be so which archipelago \u003cb\u003ewicked\u003c/b\u003e \u003cb\u003ealong\u003c/b\u003e width. Whom exaltation \u003cb\u003ehimself\u003c/b\u003e \u003cb\u003ehow\u003c/b\u003e however might ours hers \u003cb\u003eshake\u003c/b\u003e therefore. Near quite horde huge been we something honesty sing as. These down in Japanese \u003cb\u003ethey\u003c/b\u003e out \u003cb\u003eprovided\u003c/b\u003e \u003cb\u003eover\u003c/b\u003e how today.\u003c/div\u003e",
      "plain_desc": "Eye some contrast as width yourself stand are woman over. Additionally Costa that be so which archipelago wicked along width. Whom exaltation himself how however might ours hers shake therefore. Near quite horde huge been we something honesty sing as. These down in Japanese they out provided over how today.",
      "subject_tag": "[StrategyHub]",
      "footer": "This is my\nFooter!!!!",
      "website": "",
      "announce": false,
      "moderation": "moderated",
      "new_users_moderated": true,
      "unmoderate_users_after": 3,
      "restricted": true,
      "invite_only": false,
      "allow_non_subs_to_post": false,
      "force_html_emails": false,
      "normalize_html_emails": false,
      "reply_to": "group_reply_to_group",
      "remove_other_reply_options": false,
      "privacy": "group_privacy_none",
      "seperate_footers": false,
      "allow_downloads": "allow_downloads_by_members",
      "members_visible": "group_view_members_moderators",
      "sub_group_access": "sub_group_subs",
      "calendar_access": "group_access_subscribers",
      "files_access": "group_access_subscribers",
      "database_access": "group_access_subscribers",
      "wiki_access": "group_access_subscribers",
      "photos_access": "group_access_subscribers",
      "member_directory_access": "group_access_subscribers",
      "polls_access": "polls_access_subscribers",
      "chat_access": "group_access_subscribers",
      "handle_attachments": "group_attachments_normal",
      "plain_text_only": false,
      "handle_virus": "handle_virus_block",
      "locked": false,
      "plan": "group_plan_premium",
      "trial_group": false,
      "has_cover_photo": false,
      "has_icon": false,
      "parent_group_id": 0,
      "org_id": 1,
      "max_photo_size_email": "max_photo_size_none",
      "max_photo_size_photos": "max_photo_size_none",
      "max_photo_size_databases": "max_photo_size_none",
      "max_photo_size_wiki_images": "max_photo_size_none",
      "hash_tags_required": false,
      "hash_tag_permissions": "hash_tag_create_subs",
      "bounce_attachments": false,
      "allow_photos_in_files": false,
      "allow_reposts": false,
      "min_days_between_reposts": 0,
      "max_number_of_reposts": 0,
      "email_delivery_default": "email_delivery_single",
      "message_selection_default": "message_selection_all",
      "auto_follow_replies_default": false,
      "max_attachment_size_default": "max_attachment_size_small",
      "default_color": "color_cerulean_blue",
      "default_timezone": "America/Los_Angeles",
      "default_time_pref": "standard_time",
      "default_date_pref": "us_date",
      "default_monday_start": false,
      "disable_edits": false,
      "disable_no_email": false,
      "auto_close_threads": false,
      "close_threads_after": 0,
      "auto_moderate_threads": false,
      "moderate_threads_after": 0,
      "sticky_wiki_page_id": 0,
      "sub_group_categoryid": 0,
      "subs_count": 541,
      "pending_subs_count": 0,
      "pending_msgs_count": 0,
      "open_chats_count": 0,
      "threads_count": 0,
      "messages_count": 0,
      "org_domain": "",
      "most_recent_message": "2020-09-07T19:38:00-07:00",
      "cover_photo_url": "",
      "icon_url": "",
      "group_url": "",
      "allow_parent_subs_to_post": false,
      "send_event_summaries": false,
      "event_summary_schedule": "event_summary_weekly_friday",
      "send_invites_on_join": false,
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "email_address": "StrategyHub@groups.io",
      "extra_member_data_columns": [
        {
          "id": 48876437,
          "name": "Text: Lots write point week doctor.",
          "type": "text_column",
          "required": true,
          "color": "color_beige",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Movement whose also it vanish watch these to ever always."
        },
        {
          "id": 161476183,
          "name": "Paragraph: Other few covey range window.",
          "type": "paragraph_column",
          "required": true,
          "color": "color_light_brown",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Silence lastly had what outcome let while school pause up."
        },
        {
          "id": 39354277,
          "name": "Checkbox: Company freedom pout his throw.",
          "type": "checkbox_column",
          "required": true,
          "color": "color_orange",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Quarterly outfit faithful is often part whom these been hourly."
        },
        {
          "id": 8897324,
          "name": "Multiple Choice: Madagascan anyway should late yours.",
          "type": "multiple_choice_column",
          "required": true,
          "color": "color_orchid",
          "choices": [
            "Monthly ball upon almost everything dynasty.",
            "Behalf shall nearly this weekly for.",
            "Anywhere everybody over secondly then boat."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Besides pack when murder her had snore first in limp."
        },
        {
          "id": 159828550,
          "name": "Date: Which these bale nobody few.",
          "type": "date_column",
          "required": true,
          "color": "color_blush",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "How anyone these string life that who result lately yourselves."
        },
        {
          "id": 185149472,
          "name": "Time: Besides later whom for rarely.",
          "type": "time_column",
          "required": true,
          "color": "color_sage",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Each her ski ours host our as did they to."
        },
        {
          "id": 166814414,
          "name": "Address: Bravery where this as cloud.",
          "type": "address_column",
          "required": true,
          "color": "color_cucumber",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Inside since open most you that including fight murder cautiously."
        },
        {
          "id": 102385421,
          "name": "Multi Choice: Another what full her can.",
          "type": "multi_choice_column",
          "required": true,
          "color": "color_aquamute",
          "choices": [
            "Indeed besides motherhood in that nightly.",
            "Limit we kneel herself collect yourselves.",
            "Yourselves Norwegian this fear happily fruit."
          ],
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Pout nature bike moreover from whoever afterwards myself mine to."
        },
        {
          "id": 154317202,
          "name": "Link: Bale sedge Christian would whose.",
          "type": "link_column",
          "required": true,
          "color": "color_military",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Hers pack rhythm that now whose her out infancy somebody."
        },
        {
          "id": 123191768,
          "name": "Image: Today scenic consequently ours eye.",
          "type": "image_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Other other abundant some anywhere this life nevertheless in next."
        },
        {
          "id": 53386358,
          "name": "HTML Paragraph: Nobody what today e.g. loss.",
          "type": "html_paragraph_column",
          "required": true,
          "color": "color_emerald_green",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Spite Philippine before throughout wander of as there next of."
        },
        {
          "id": 45812071,
          "name": "Email: That because am terribly many.",
          "type": "email_column",
          "required": true,
          "color": "color_light_grey",
          "width": 0,
          "default_hidden": false,
          "profile": false,
          "description": "Because anyone does you hungrily can several might who monthly."
        }
      ]
   },
 "member_info": 
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   },
 "modded_member_info": 
   {
      "id": 93846546,
      "object": "member_info",
      "created": "2020-09-09T04:11:00-07:00",
      "updated": "2022-06-08T07:16:00-07:00",
      "user_id": 147779411,
      "group_id": 8658933,
      "group_name": "StrategyHub",
      "status": "sub_status_normal",
      "post_status": "sub_poststatus_newusermoderated",
      "email_delivery": "email_delivery_digest",
      "message_selection": "message_selection_follow_and_first_message",
      "auto_follow_replies": false,
      "max_attachment_size": "max_attachment_size_medium",
      "approved_posts": 0,
      "mod_status": "sub_modstatus_owner",
      "pending_msg_notify": "sub_notify_email_and_app",
      "pending_sub_notify": "sub_notify_email_and_app",
      "sub_notify": "sub_notify_email_and_app",
      "storage_notify": "sub_notify_email_and_app",
      "sub_group_notify": "sub_notify_email_and_app",
      "message_report_notify": "sub_notify_email_and_app",
      "account_notify": "sub_notify_email_and_app",
      "mod_permissions": "sub_perm_pendingmsg,sub_perm_pendingmembers,sub_perm_invitemembers,sub_perm_removemembers,sub_perm_banmembers,sub_perm_makemoderator,sub_perm_managehashtags,sub_perm_groupsettings,sub_perm_modsub,sub_perm_integrations,sub_perm_editarchives,sub_perm_billing,sub_perm_managesubgroups,sub_perm_viewmembers,sub_perm_managepaidsubscriptions",
      "owner_msg_notify": "sub_ownermsg_notify_subs",
      "chat_notify": "sub_notify_email_and_app",
      "photo_notify": "sub_notify_email_and_app",
      "file_notify": "sub_notify_email_and_app",
      "wiki_notify": "sub_notify_email_and_app",
      "database_notify": "sub_notify_email_and_app",
      "email": "gersonbeahan@jacobi.io",
      "user_status": "user_status_confirmed",
      "user_name": "Dickens6041",
      "timezone": "America/Chicago",
      "full_name": "Lawson Kreiger",
      "about_me": "Today awfully arrive at",
      "location": "Well away onto",
      "website": "http://www.centralgenerate.com/scalable/best-of-breed/deliver/content",
      "profile_photo_url": "https://s3-us-west-1.amazonaws.com/profilephoto.https://picsum.photos/id/53/498/325?AWSAccessKeyId=\u0026Expires=1758644902\u0026Signature=IHqNubyuSuaVLfSl2lQRwVAY0UA%3D",
      "profile_privacy": "profile_private",
      "dont_munge_message_id": false,
      "use_signature": false,
      "use_signature_email": false,
      "signature": "In hotel furniture anyone weakly besides",
      "color": "color_cerulean_blue",
      "cover_photo_url": "",
      "icon_url": "",
      "nice_group_name": "",
      "subs_count": 0,
      "most_recent_message": "0001-01-01T00:00:00Z",
      "perms": {
        "object": "perms",
        "archives_visible": true,
        "polls_visible": true,
        "members_visible": true,
        "chat_visible": true,
        "calendar_visible": true,
        "files_visible": true,
        "database_visible": true,
        "photos_visible": true,
        "wiki_visible": true,
        "member_directory_visible": true,
        "hashtags_visible": true,
        "guidelines_visible": true,
        "subgroups_visible": true,
        "open_donations_visible": true,
        "sponsor_visible": true,
        "manage_subgroups": true,
        "ask_visible": true,
        "delete_group": true,
        "download_archives": true,
        "download_entire_group": true,
        "download_members": true,
        "view_activity": true,
        "create_hashtags": true,
        "manage_hashtags": true,
        "manage_integrations": true,
        "manage_group_settings": true,
        "make_moderator": true,
        "manage_member_subscription_options": true,
        "manage_pending_members": true,
        "remove_members": true,
        "ban_members": true,
        "manage_group_billing": true,
        "manage_group_payments": true,
        "edit_archives": true,
        "manage_pending_messages": true,
        "invite_members": true,
        "can_post": true,
        "can_reply": true,
        "can_vote": true,
        "manage_polls": true,
        "manage_photos": true,
        "manage_members": true,
        "manage_calendar": true,
        "manage_chats": true,
        "view_member_directory": true,
        "manage_files": true,
        "manage_wiki": true,
        "manage_subscription": true,
        "public_page": true,
        "sub_page": true,
        "mod_page": true,
        "can_ask": true
      },
      "member_labels": [
        {
          "id": 726,
          "object": "memberlabel",
          "created": "2020-09-29T22:19:00Z",
          "group_id": 1857,
          "name": "Florida",
          "description": "My poor troop frequently dynasty instance dive now door she. Exemplified tomato sedge Himalayan has define bale on this library. Promise us congregation backwards most that leap ream yearly occur. Her nobody are next party little hers hers today case. Towards herself African each our food nearby e.g. understand addition.",
          "color_name": "green-sage",
          "color_hex": "#9fc4ac"
        },
        {
          "id": 1594,
          "object": "memberlabel",
          "created": "2020-09-24T02:24:00Z",
          "group_id": 42,
          "name": "Russel",
          "description": "Infrequently idea she from which what always in have it. Eventually city under sleepy shake child early garden caused as. Become lazily wheelchair by her that exaltation homeless spoon now. Its her roll another what climb crew something body then. I fortnightly on must his never research scary band at.",
          "color_name": "purple",
          "color_hex": "#837fd5"
        },
        {
          "id": 1189,
          "object": "memberlabel",
          "created": "2020-09-12T02:11:00Z",
          "group_id": 1474,
          "name": "Meta",
          "description": "Man significant British few over before addition pack my whose. This secondly that what them myself soon so extremely yourselves. Whose since shower quietly each in carry through innocence what. Him his why hers they theirs who us who of. This that above youth with fashion tonight her seldom work.",
          "color_name": "sky",
          "color_hex": "#9cc7df"
        }
      ],
      "extra_member_data": [
        {
          "col_id": 48876437,
          "col_type": "text_column",
          "text": "To firstly unlock while host himself me purely as whose."
        },
        {
          "col_id": 161476183,
          "col_type": "paragraph_column",
          "text": "Yet few mustering example will addition yearly since in these."
        },
        {
          "col_id": 39354277,
          "col_type": "checkbox_column",
          "checked": false
        },
        {
          "col_id": 8897324,
          "col_type": "multiple_choice_column",
          "multi_choice": [
            0
          ]
        },
        {
          "col_id": 159828550,
          "col_type": "date_column",
          "date": "1916-10-16T17:57:55.797000001Z"
        },
        {
          "col_id": 185149472,
          "col_type": "time_column",
          "time": "1919-03-30T18:00:36.790929649Z"
        },
        {
          "col_id": 166814414,
          "col_type": "address_column",
          "street_address1": "Premier Medical Group",
          "street_address2": "3701 DAUPHIN ST",
          "city": "MOBILE",
          "state": "AL",
          "zip": "36608-1756",
          "lat": 30.6866076,
          "lng": -88.13019249999999
        },
        {
          "col_id": 102385421,
          "col_type": "multi_choice_column",
          "multi_choice": [
            0,
            1,
            2
          ]
        },
        {
          "col_id": 154317202,
          "col_type": "link_column",
          "title": "To say poorly out according abundant unless nervously string lastly.",
          "url": "https://www.leade-tailers.biz/facilitate/facilitate/impactful/deliver",
          "desc": "Advertising faithfully it later depend deeply everybody rhythm for had."
        },
        {
          "col_id": 123191768,
          "col_type": "image_column",
          "url": "https://picsum.photos/id/27/187/110",
          "image_name": "Lately blazer with wild hourly there she it infrequently power."
        },
        {
          "col_id": 53386358,
          "col_type": "html_paragraph_column",
          "html_text": "\u003cdiv\u003eTonight \u003cb\u003eseveral\u003c/b\u003e \u003cb\u003eits\u003c/b\u003e \u003cb\u003ewhich\u003c/b\u003e \u003cb\u003esince\u003c/b\u003e \u003cb\u003etomorrow\u003c/b\u003e tonight your bag yourself our \u003cb\u003ehis\u003c/b\u003e which be \u003cb\u003eitself\u003c/b\u003e \u003cb\u003emine\u003c/b\u003e \u003cb\u003ethis\u003c/b\u003e \u003cb\u003eyesterday\u003c/b\u003e I smell.\u003c/div\u003e"
        },
        {
          "col_id": 45812071,
          "col_type": "email_column",
          "text": "brantkozey@bernhard.com"
        }
      ]
   },
 "non_member_email": "",
 "msg_num": 63,
 "subject": "",
 "message": "",
 "extra": "",
 "extra2": "",
 "extra_id": 63,
 "extended_data": "",
}

The Webhook Subscription Object

The webhook subscription object.

Response Attributes

object string	Type of object. Is set to `webhook_subscription`.
created date	The time this subscription was created.
updated date	The last time this subscription was updated.
url string	The URL we are to POST `webhook_event` objects to.
secret string	If specified, `webhook_events` will include a X-Groupsio-Signature header, which is an HMAC hex digest using the sha1 hash function and the `secret` as the HMAC key.
group_ids number	The group monitored by this subscription.
include_subgroups boolean	If monitoring a group, whether to monitor subgroups as well.
actions array of string	The list of actions monitored by this subscription. Can be: `joined`, `added_member`, `created_subgroup`, `deleted_subgroup`.

Example Object

{
 "object": "webhook_subscription",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "url": "https://example.com/webhook",
 "secret": "blahblahblah",
 "group_ids": 31,
 "include_subgroups": false,
 "actions": ["created_subgroup"],
}

The Wiki Data Object

The wiki_data object, representing one revision of a wiki page.

Response Attributes

id number
object string	wiki_data.
created date
updated date
user_id number
group_id number
page_id number
body string	The body of the wiki page, in HTML format.
edit_msg string	Optional edit message.

Example Object

{
   "id": 189165006,
   "object": "wiki_data",
   "created": "2020-09-14T08:42:00-07:00",
   "updated": "2022-07-09T08:28:00-07:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "page_id": 52691321,
   "body": "Any it such so annually myself cloud these Lebanese Guyanese you herself. Greatly one being nest when itself yet unless outfit were anybody these. It envy sit too consequently which egg lastly correctly is hand early. You moreover seed those someone daily to them backwards this that provided. Store elegance joy group Senegalese whichever happen trade move outside downstairs of.\u003cbr/\u003eExemplified up out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for her our. Much nevertheless which numerous alone bevy as by from e.g. otherwise laptop. Cloud then them yourselves few look fleet say still patrol finally Vietnamese. Painting otherwise its to a e.g. congregation cackle themselves previously in for.\u003cbr/\u003eTheirs they my there road disappear accordingly hotel so today by over. Have this Romanian abroad around while belong ever into each whatever fortnightly. He agreeable sari anyone therefore does could exaltation of sit everyone they. Had mustering would as yesterday we inquire ourselves his laugh string several. Accordingly kindness bit stand woman just poised they enough thing homework each.",
   "edit_msg": "Clothing other cry"
}

The Wiki Page Object

The wiki_page object, representing the meta data for a wiki page.

Response Attributes

id number
object string	wiki_page.
created date
updated date
user_id number
group_id number
title string	Title of the wiki page.
path string	Path is Title converted to a wiki page path.
locked boolean
datas optional array of Wiki Data objects	The iterations of the wiki page itself.
rev_count number	The current revision count of the wiki page.

Example Object

{
   "id": 52691321,
   "object": "wiki_page",
   "created": "2020-09-15T02:30:00-07:00",
   "updated": "2021-03-01T18:07:00-08:00",
   "user_id": 147779411,
   "group_id": 8658933,
   "title": "Including tribe anything from whose market",
   "path": "Including-tribe-anything-from-whose-market",
   "locked": false,
   "rev_count": 43
}

The Wiki Page List Object

Wiki Page List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
data array of Wiki Page objects

Methods That Use This Object

Get Wiki Pages	View Method

Example Object

{
   "object": "list",
   "total_count": 14,
   "start_item": 4,
   "end_item": 590,
   "has_more": true,
   "next_page_token": 1602,
   "sort_field": "created",
   "second_order": "members",
   "query": "testsearch",
   "sort_dir": "asc",
   "data": [
     {
       "id": 52691321,
       "object": "wiki_page",
       "created": "2020-09-02T00:51:00-07:00",
       "updated": "2022-06-03T11:42:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "title": "Including tribe anything from whose",
       "path": "Including-tribe-anything-from-whose",
       "locked": false,
       "rev_count": 30
     },
     {
       "id": 29743360,
       "object": "wiki_page",
       "created": "2020-10-01T09:06:00-07:00",
       "updated": "2022-06-06T16:00:00-07:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "title": "Yourself any it such so",
       "path": "Yourself-any-it-such-so",
       "locked": false,
       "rev_count": 37
     },
     {
       "id": 83034458,
       "object": "wiki_page",
       "created": "2020-09-14T20:59:00-07:00",
       "updated": "2022-11-29T01:40:00-08:00",
       "user_id": 147779411,
       "group_id": 8658933,
       "title": "E.g. fear usually",
       "path": "E.g.-fear-usually",
       "locked": false,
       "rev_count": 1
     }
   ]
}

The Wiki Page Set Object

Wiki Page Set

Response Attributes

page Wiki Page object	The wiki page itself.
data Wiki Data object	The wiki page itself.
sidebar optional Wiki Data object	The optional sidebar.
footer optional Wiki Data object	The optional footer.

Methods That Use This Object

New Wiki Page	View Method
Update Wiki Page	View Method
Get Wiki Page Set	View Method

Example Object

{
   "page": {
     "id": 52691321,
     "object": "wiki_page",
     "created": "2020-09-15T02:30:00-07:00",
     "updated": "2021-03-01T18:07:00-08:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "title": "Including tribe anything from whose market",
     "path": "Including-tribe-anything-from-whose-market",
     "locked": false,
     "rev_count": 43
   },
   "data": {
     "id": 189165006,
     "object": "wiki_data",
     "created": "2020-09-14T08:42:00-07:00",
     "updated": "2022-07-09T08:28:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Any it such so annually myself cloud these Lebanese Guyanese you herself. Greatly one being nest when itself yet unless outfit were anybody these. It envy sit too consequently which egg lastly correctly is hand early. You moreover seed those someone daily to them backwards this that provided. Store elegance joy group Senegalese whichever happen trade move outside downstairs of.\u003cbr/\u003eExemplified up out destroy due taste anything where this that would whom. To cautiously till only himself fight our whomever that for her our. Much nevertheless which numerous alone bevy as by from e.g. otherwise laptop. Cloud then them yourselves few look fleet say still patrol finally Vietnamese. Painting otherwise its to a e.g. congregation cackle themselves previously in for.\u003cbr/\u003eTheirs they my there road disappear accordingly hotel so today by over. Have this Romanian abroad around while belong ever into each whatever fortnightly. He agreeable sari anyone therefore does could exaltation of sit everyone they. Had mustering would as yesterday we inquire ourselves his laugh string several. Accordingly kindness bit stand woman just poised they enough thing homework each.",
     "edit_msg": "Clothing other cry"
   },
   "sidebar": {
     "id": 126768040,
     "object": "wiki_data",
     "created": "2020-09-06T17:44:00-07:00",
     "updated": "2021-07-07T18:15:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Those line over elegantly say woman pen today as now ourselves first. For without what might any where as out me were Norwegian significant. His do mob notice lastly theirs hotel one calm that later does. Point throw neatly usually Kazakh without for one from soon swing whose. Man confusing case Bangladeshi how most somewhat several week e.g. who earlier.\u003cbr/\u003eGentle catalog ourselves then tonight bend may yearly since limit e.g. besides. Chest their hair out work data sedge this might how group out. Then result these preen numerous on frequently him at tonight is seriously. Why kiss logic beyond him swing our Amazonian will for myself everybody. I abundant few weekly anyone an weekly someone being that her enthusiasm.\u003cbr/\u003eYours never without theirs mine that delay that the air whatever bundle. You is such batch accommodation without now in yearly adventurous her for. Previously as of along nobody back hers numerous would our bra yours. Union Bangladeshi Bahamian now wiggle should our example eye woman in religion. Am collapse regiment in were choir troop speed throw year work let.",
     "edit_msg": "Bunch one choir those horror would is"
   },
   "footer": {
     "id": 9000308,
     "object": "wiki_data",
     "created": "2020-09-06T02:40:00-07:00",
     "updated": "2020-10-07T01:03:00-07:00",
     "user_id": 147779411,
     "group_id": 8658933,
     "page_id": 52691321,
     "body": "Close disregard completely decidedly which exaltation decidedly think niche annoyance yesterday hence. As him his this one into this she choir they of him. Some calm that engine our capture it that infrequently accordingly something with. Adult last often finally tonight congregation of so sneeze care massage it. Road behind recently Atlantic tea difficult were another his then afterwards finally.\u003cbr/\u003eHimself I yearly by them yet from after whom ream when fortnightly. Whose dark why besides aunt what caravan Icelandic Shakespearean theirs point spotted. Those but clap really now ourselves there rice Burmese graceful say cloud. So secondly besides moreover her sadly later several listen example answer that. Under below peacock Roman despite herself ring early outfit what are fatally.\u003cbr/\u003eRice which the door him how regularly any any key often crew. Talent it theirs disregard theirs his regularly bunch according next for French. Pretty yourselves that nutrition disregard he distinguish bones your usually as quarterly. Fondly dress pleasure ourselves my that party begin close frightening accordingly still. She outside smell hourly union anyone him leap long as had pancake.",
     "edit_msg": "Any annually gang dream without might may"
   }
}

The Wiki Search Result Object

The topic objecsr.

Response Attributes

id number
object string	wiki_search_result.
created date
updated date
user_id number
group_id number
data_id number
title string	Title of the page.
rev_count number	How many times this wiki page has been edited.
body string	Wiki page body, in HTML.
edit_msg string	Edit message for this revision, if one.
snippet string	Matching summary, in HTML.

Example Object

{
 "id": 23,
 "object": "wiki_search_result",
 "created": "2009-11-10T15:00:00-08:00",
 "updated": "2009-11-10T15:00:00-08:00",
 "user_id": 74,
 "group_id": 63,
 "data_id": 36,
 "title": "",
 "rev_count": 28,
 "body": "",
 "edit_msg": "",
 "snippet": "",
}

The Wiki Search Results List Object

Wiki Search Results List

Response Attributes

object string	list.
total_count number	The total number of items available.
start_item number	The index of the first item, from 0.
end_item number	The index of the last item, from 0.
has_more boolean	Whether there are more items available.
next_page_token number	An opaque token that is to be returned to fetch the next set of objects.
sort_field string	The field to sort on. Valid values are dependent on the call.
second_order string	Optional second order/filter.
query string	If we're paging through search results, this is the search string.
sort_dir string	Sort direction. Can be `asc` or `desc`.
group_id number	ID of the group these results are from.
query string	The query string.
data array of Wiki Search Result objects

Methods That Use This Object

Search Wikis	View Method

Example Object

{
 "object": "list",
 "total_count": 65,
 "start_item": 17,
 "end_item": 40,
 "has_more": false,
 "next_page_token": 38,
 "sort_field": "",
 "second_order": "",
 "query": "",
 "sort_dir": "",
 "group_id": 53,
 "query": "",
 "data": [
   {
    "id": 57,
    "object": "wiki_search_result",
    "created": "2009-11-10T15:00:00-08:00",
    "updated": "2009-11-10T15:00:00-08:00",
    "user_id": 56,
    "group_id": 81,
    "data_id": 26,
    "title": "",
    "rev_count": 23,
    "body": "",
    "edit_msg": "",
    "snippet": "",
   }
 ],
}

Types referenced by Objects and Endpoints.

The action type

Possible Values

accepted_invitation string	Invitation - Accepted
added_album string	Photo - Added album
added_alias string	Membership - Email alias added by member
added_banned_domain string	Banned - Domain added to banned list
added_bluesky_integration string	Integration - Added Bluesky integration
added_dir string	File - Folder added
added_email_integration string	Integration - Added email integration
added_event string	Calendar - Added event
added_facebook_integration string	Integration - Added Facebook integration
added_file string	File - Added
added_github_integration string	Integration - Added Github integration
added_group_alias string	Group - Alias added
added_group_notice string	Member Notice - Added
added_hashtag string	Hashtag - Added
added_instagram_integration string	Integration - Added Instagram integration
added_member string	Membership - Moderator direct-added new member
added_member_label string	Membership - Added member label
added_photo string	Photo - Added
added_repeat_event string	Calendar - Added repeating event
added_row string	Database - Added row
added_rss_integration string	Integration - Added feed integration
added_table string	Database - Added database
added_trello_integration string	Integration - Added Trello integration
added_wiki_image string	Wiki - Image added
added_wiki_page string	Wiki - Page created
applied string	Membership - Pending member applied to group
approved_member string	Membership - Moderator approved new member
approved_pending_message string	Pending Message - Approved
attachments_deleted_for_space string	Message - Attachment deleted for space
attempt_sub_banned_member string	Banned - Member attempted to subscribe
attempted_banned_domain_owner string	Message - To +owner rejected from banned domain
attempted_banned_domain_post string	Rejected Message - Banned domain
attempted_banned_domain_registration string	Membership - System rejected potential member due to banned domain
attempted_file_add_with_virus string	File - Attempted add with virus
bad_expired_thread string	Bad expired thread
banned_by_system string	Banned - System banned member
banned_member string	Banned - Moderator banned member
bounced_user string	Bouncing - System bounced member
bouncing_user string	Bouncing - System set member to bouncing
canceled_event string	Calendar - Canceled event
changed_email string	Membership - Email address changed by member
changed_fullname string	Membership - Display name changed by member
changed_payer string	Billing - Invoice payer changed
changed_thread_replyto string	Topic - Reply-to changed
changed_thread_subject string	Topic - Subject changed
changed_username string	Membership - Username changed by member
claimed_pending_member string	Membership - Moderator claimed pending member
claimed_pending_message string	Pending Message - Claimed
closed_thread string	Topic - Locked
color_changed string	Membership - Moderator changed member subscription color
confirmed_account string	Account - Confirmed
created_group string	Group - Created
created_subgroup string	Subgroup - Created
deleted_account string	Account - Deleted
deleted_album string	Photo - Deleted album
deleted_alias string	Membership - Email alias deleted by member
deleted_attachment string	Message - Edited to delete attachment
deleted_banned_domain string	Banned - Domain deleted from banned list
deleted_chat_message string	Chat - Deleted message
deleted_dir string	File - Folder deleted
deleted_event string	Calendar - Deleted event
deleted_file string	File - Deleted
deleted_following_repeat_event string	Calendar - Deleted following repeating event
deleted_group_alias string	Group - Alias deleted
deleted_group_notice string	Member Notice - Deleted
deleted_message string	Message - Deleted
deleted_message_edit string	Message - Edit deleted
deleted_pending_message string	Pending Message - Deleted
deleted_photo string	Photo - Deleted
deleted_repeat_event string	Calendar - Deleted repeating event
deleted_row string	Database - Deleted row
deleted_subgroup string	Subgroup - Deleted
deleted_table string	Database - Deleted database
deleted_thread string	Topic - Deleted
deleted_wiki_image string	Wiki - Image deleted
deleted_wiki_page string	Wiki - Page deleted
deleted_wiki_rev string	Wiki - Revision deleted
delivery_changed string	Membership - Email delivery changed by member
delivery_changed_by_moderator string	Membership - Email delivery changed by moderator
donation_closed string	Donation - Request closed
donation_reopened string	Donation - Request reopened
donation_requested string	Donation - Request created
donation_updated string	Donation - Request updated
edited_album string	Photo - Edited album
edited_bluesky_integration string	Integration - Edited Bluesky integration
edited_email_integration string	Integration - Edited email integration
edited_extra_data string	Membership - Extra data changed by member
edited_facebook_integration string	Integration - Edited Facebook integration
edited_github_integration string	Integration - Edited Github integration
edited_group string	Group - Settings changed
edited_group_notice string	Member Notice - Edited
edited_hashtag string	Hashtag - Edited
edited_instagram_integration string	Integration - Edited Instagram integration
edited_member_label string	Membership - Edited member label
edited_message string	Message - Edited
edited_message_no_send_unused string	Edited message without sending to the group
edited_moderator_note string	Membership - Member Notes edited by moderator
edited_photo string	Photo - Edited
edited_rss_integration string	Integration - Edited feed integration
edited_trello_integration string	Integration - Edited Trello integration
event_changed_rsvp string	Calendar - Member RSVP changed
event_moved_from_waitlist string	Calendar - Member moved off waitlist
event_rsvp_maybe string	Calendar - Member RSVP \"not sure\"
event_rsvp_no string	Calendar - Member RSVP \"no\"
event_rsvp_yes string	Calendar - Member RSVP \"yes\"
expired_hashtag string	Hashtag - Expired
expired_member string	Membership - Pending membership expired
expired_pending_message string	Pending Message - Expired
exported_group string	Group - Exported
extra_data_changed_by_moderator string	Membership - Extra data changed by moderator
guidelines_sent string	Group - Guidelines sent
invited_member string	Invitation - Sent
joined string	Membership - Member joined
left string	Membership - Member left
locked_event string	Calendar - Locked event
member_donated string	Donation - Made by member
member_donation_failed string	Donation - Failed by member
member_label_changed string	Membership - Moderator changed member's member labels
member_sponsored string	Group - Sponsorship made
member_sponsorship_failed string	Group - Sponsorship failed
merge_threads string	Topic - Merged topics
message_to_attendees string	Calendar - Message to attendees
mod_changed_email string	Membership - Email address changed by moderator
mod_changed_fullname string	Membership - Display name changed by moderator
moderated_thread string	Topic - Moderated
moderator_changed string	Membership - Moderator's permissions changed by moderator
modified_dir string	File - Folder modified
modified_event string	Calendar - Modified event
modified_file string	File - Modified
modified_repeat_event string	Calendar - Modified repeating event
modified_row string	Database - Modified row
modified_table string	Database - Modified database
modified_wiki_page string	Wiki - Page edited
monthly_reminder_sent string	Group - Monthly reminder sent
moved_dir string	File - Folder moved
moved_file string	File - Moved
moved_photo string	Photo - Moved
notifications_changed string	Membership - Notifications changed by member
notifications_changed_by_moderator string	Membership - Notifications changed by moderator
paid_invoice string	Billing - Invoice for group paid
plan_change string	Billing - Plan type changed
post_to_sub string	Message - To member
poststatus_changed string	Membership - Posting privileges changed by moderator
prevented_from_joining string	Membership - System prevented potential member from joining due to full group
reinvited_member string	Membership - Moderator re-sent invitation
rejected_member string	Membership - Moderator rejected pending member
rejected_pending_message string	Pending Message - Rejected
removed_bluesky_integration string	Integration - Removed Bluesky integration
removed_email_integration string	Integration - Removed email integration
removed_facebook_integration string	Integration - Removed Facebook integration
removed_github_integration string	Integration - Removed Github integration
removed_hashtag string	Hashtag - Removed
removed_instagram_integration string	Integration - Removed Instagram integration
removed_invite string	Invitation - Removed
removed_member string	Membership - Member removed
removed_member_label string	Membership - Removed member label
removed_rss_integration string	Integration - Removed feed integration
removed_trello_integration string	Integration - Removed Trello integration
reopened_thread string	Topic - Unlocked
reported_file string	File - Reported
reported_message string	Message - Reported
reported_photo string	Photo - Reported
resent_confirmation string	Membership - Moderator re-sent confirmation email
resent_pending_member_notice string	Membership - Moderator re-sent pending member notice
resumed_membership string	Membership - Member resumed group membership
rotated_photo string	Photo - Rotated
sent_bounce_probe string	Bouncing - Bounce probe sent
sent_message_accepted string	Message - Sent
sent_message_announcement string	Rejected Message - To announcement group
sent_message_announcement_password string	Rejected Message - Incorrect announcement group password
sent_message_attachment_bounced string	Rejected Message - Due to attachment
sent_message_banned string	Rejected Message - Banned member
sent_message_bounced_sub string	Rejected Message - Bouncing member
sent_message_cant_add_event string	Calendar - No permission to add event
sent_message_cant_create_tags string	Rejected Message - New hashtag
sent_message_closed_topic string	Rejected Message - Locked topic
sent_message_mod_only_tags string	Rejected Message - Moderator-only hashtag
sent_message_moderated string	Pending Message - Received
sent_message_no_tags string	Rejected Message - No hashtag
sent_message_not_allowed string	Rejected Message - Member who can't post
sent_message_not_confirmed_sub string	Rejected Message - Not-confirmed member
sent_message_not_subscriber string	Rejected Message - Non-member
sent_message_pending_sub string	Rejected Message - Pending member
sent_message_too_big string	Rejected Message - Too large
sent_to_owner string	Message - To +owner
sig_changed string	Membership - Signature changed by member
sig_changed_by_moderator string	Membership - Signature changed by moderator
spam_left string	Spam - System removed member due to spam report
spam_sent_to_owner string	Message - Spam message to +owner
split_thread string	Topic - Split
sticky_thread string	Topic - Made sticky
stripe_account_connected string	Donations - Stripe account connected
stripe_account_disconnected string	Donations - Stripe account disconnected
unbanned_member string	Banned - Moderator unbanned member
unbounced_user string	Bouncing - Member unbounced themselves
unlocked_event string	Calendar - Unlocked event
unmoderated_thread string	Topic - Unmoderated
unsticky_thread string	Topic - Unstuck
virus_bounced_member string	Rejected Message - From member due to virus
virus_bounced_nonmember string	Rejected Message - Non-member due to virus
virus_moderated_message string	Message from member required approval because of virus

The delivery_type type

Possible Values

delivery_bounce_probe string	Bounce probe message
delivery_confirmation string	Confirmation email
delivery_digest string	Digest message
delivery_direct_add string	Direct add message
delivery_invite string	Invite delivery, not stored
delivery_login_link string	Login link message
delivery_member_notice string	Member notice
delivery_mod_notice string	Moderator notification, type is indicated by MsgID
delivery_reply string	Reply to sender
delivery_reverify string	Re-verification email
delivery_single string	Single message
delivery_summary string	Summary message
delivery_to_owner string	Message sent to a moderator via the +owner address
delivery_to_sub string	Message to subscriber

API Reference - ALPHA

API Endpoints

Versioning And Change Log

What changes does Groups.io consider to be “backwards-compatible”?

Success

Example Success Response

Errors

Example Error Response

Extended Return Information

Pagination

Example Response

Libraries

Authentication

Authentication

API Keys (Recommended)

Session-Based Authentication

Activity Log

Get Activity Log

GET /api/v1/getactivitylogcURL cURLGoJavaScript

Example Successful Response

Example Error Response

Archives

Get Topics

GET /api/v1/gettopicscURL cURLGoJavaScript

Example Successful Response

Example Error Response

Get Topic

GET /api/v1/gettopiccURL cURLGoJavaScript

Example Successful Response

Example Error Response

Get Messages

GET /api/v1/getmessagescURL cURLGoJavaScript

Example Successful Response

Example Error Response

Download Archives

GET /api/v1/downloadarchivescURL cURLGoJavaScript

Example Error Response

Search Archives

GET /api/v1/searcharchivescURL cURLGoJavaScript

Example Successful Response

Example Error Response

Get Message History

GET /api/v1/getmessagehistorycURL cURLGoJavaScript

Example Successful Response

Example Error Response

Chats

New Chat

POST /api/v1/newchatcURL cURLGoJavaScript

Example Successful Response

Example Error Response

Update Chat

POST /api/v1/updatechatcURL cURLGoJavaScript

Example Successful Response

Example Error Response

Get Chats

GET /api/v1/getchatscURL cURLGoJavaScript

Example Successful Response

Example Error Response

Delete Chat

POST /api/v1/deletechatcURL cURLGoJavaScript

Successful Response

Example Error Response

Join Chat

POST /api/v1/joinchatcURL cURLGoJavaScript

Example Successful Response

Example Error Response

Chat Members

POST /api/v1/chatmemberscURL cURLGoJavaScript

Example Successful Response

Example Error Response

Leave Chat

POST /api/v1/leavechatcURL cURLGoJavaScript

Successful Response

Example Error Response

Get Chat History

GET /api/v1/getchathistorycURL cURLGoJavaScript

Example Successful Response

Example Error Response

Databases

Get Databases

GET /api/v1/getactivitylog
cURL
Go
JavaScript

GET /api/v1/gettopics
cURL
Go
JavaScript

GET /api/v1/gettopic
cURL
Go
JavaScript

GET /api/v1/getmessages
cURL
Go
JavaScript

GET /api/v1/downloadarchives
cURL
Go
JavaScript

GET /api/v1/searcharchives
cURL
Go
JavaScript

GET /api/v1/getmessagehistory
cURL
Go
JavaScript

POST /api/v1/newchat
cURL
Go
JavaScript

POST /api/v1/updatechat
cURL
Go
JavaScript

GET /api/v1/getchats
cURL
Go
JavaScript

POST /api/v1/deletechat
cURL
Go
JavaScript

POST /api/v1/joinchat
cURL
Go
JavaScript

POST /api/v1/chatmembers
cURL
Go
JavaScript

POST /api/v1/leavechat
cURL
Go
JavaScript

GET /api/v1/getchathistory
cURL
Go
JavaScript

GET /api/v1/getdatabases
cURL
Go
JavaScript

GET /api/v1/getdatabaserows
cURL
Go
JavaScript

GET /api/v1/getdeliveryinfo
cURL
Go
JavaScript

GET /api/v1/getbounceinfo
cURL
Go
JavaScript

POST /api/v1/newdraft
cURL
Go
JavaScript

POST /api/v1/updatedraft
cURL
Go
JavaScript

GET /api/v1/getdrafts
cURL
Go
JavaScript

POST /api/v1/deletedraft
cURL
Go
JavaScript

POST /api/v1/uploadattachments
cURL
Go
JavaScript

GET /api/v1/getattachments
cURL
Go
JavaScript

POST /api/v1/deleteattachment
cURL
Go
JavaScript

POST /api/v1/postdraft
cURL
Go
JavaScript

GET /api/v1/getevent
cURL
Go
JavaScript

GET /api/v1/getevents
cURL
Go
JavaScript

POST /api/v1/rsvp
cURL
Go
JavaScript

POST /api/v1/addevent
cURL
Go
JavaScript