Group

Update existing Group

Modifies the configuration, features, and default automated responses for an existing group. Use this endpoint to update properties like the group name, description, notification preferences, and compliance messaging layouts.

put/orgunit/{orgunitId}/groups/{groupId}

Request

Base URL
https://api-docs.ministrybytext.com (the document declares no server; this is the origin it was published from)
Auth
none declared
TypeScript
https://skmtc.dev/ministrybytext/apis/pbt-api-documentation/docs/orgunit/:orgunitId/groups/:groupId/put.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

groupIdstring required

groupId

orgunitIdstring required

orgunitId

Request body

namestring required

The official descriptive name of the group. Must be unique within the organization unit.

descriptionstring nullable

An optional text summary providing additional context or organizational details about the group's purpose.

infoboolean

Set to true to establish this as an INFO group used exclusively for information-only keywords. When true, the group cannot maintain subscribers.

whatsappboolean

Set to true to establish this as a WHATSAPP group used exclusively for WhatsApp related subscribers.

notificationMobileNosstring[] nullable

An array of mobile phone numbers that will receive notifications regarding inbound messages.

notificationEmailsstring[] nullable

An array of administrative email addresses that will receive notifications regarding inbound messages.

chatEnabledboolean

Enables or disables two-way interactive chat messaging (inbox) for subscribers within this group.

autoReponseboolean

When set to true, enables automated system responses to be sent back to subscribers based inbound messages.

autoResponseMessagestring nullable

The text payload delivered to a subscriber as a standard automated fallback response when 'autoReponse' is enabled.

helpMessagestring nullable

The custom compliance message sent to non-subscribers who text the 'HELP' keyword to your communication code.

stopMessagestring nullable

The custom compliance confirmation text sent to non-subscribers who opt out by replying with the 'STOP' keyword.

optinMessagestring nullable

The custom welcome/compliance message delivered to a subscriber immediately after successfully opting into this group.

Response

Success

appCodestring

messagestring

isErrorboolean

Changes

No recorded changes to this operation across all 5 revisions of this API.