Browse Platform API
Platform API

Before inviting users to a group

Copy

Validate a group invitation and optionally refuse individual invitees.

HTTP request

POST {WEBHOOK_ADDRESS}/callbackBeforeInviteJoinGroupCommand

Request body

PropertyTypeDescription
callbackCommandstringcallbackBeforeInviteJoinGroupCommand.
operationIDstringOpenIM operation trace ID.
groupIDstringGroup ID.
reasonstringInvitation reason.
invitedUserIDsstring[]User IDs to invite.

Response

Return the common before-event fields from Webhooks overview. Set refusedMembersAccount to the user IDs that must not be added.

Processing rules

  • Configuration key: beforeInviteUserToGroup.
  • OpenIM waits synchronously. Use nextCode: 1 to reject the entire invitation; timeout behavior follows failedContinue.