{"componentChunkName":"component---src-templates-docs-js","path":"/whatsapp/messaging/groups","result":{"data":{"site":{"siteMetadata":{"title":"broadcaster","docsLocation":"https://github.com","docsLocationType":"github","editable":false}},"mdx":{"fields":{"id":"9e228a38-1837-5151-b99e-2678ec5a37b4","title":"Group messages","slug":"/whatsapp/messaging/groups"},"body":"function _extends() { _extends = Object.assign || function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }\n\nfunction _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }\n\nfunction _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }\n\n/* @jsx mdx */\nvar _frontmatter = {\n  \"title\": \"Group messages\",\n  \"order\": 5\n};\nvar layoutProps = {\n  _frontmatter: _frontmatter\n};\nvar MDXLayout = \"wrapper\";\nreturn function MDXContent(_ref) {\n  var components = _ref.components,\n      props = _objectWithoutProperties(_ref, [\"components\"]);\n\n  return mdx(MDXLayout, _extends({}, layoutProps, props, {\n    components: components,\n    mdxType: \"MDXLayout\"\n  }), mdx(\"blockquote\", null, mdx(\"p\", {\n    parentName: \"blockquote\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Integration summary\")), mdx(\"ul\", {\n    parentName: \"blockquote\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Base URL:\"), \" \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"https://{{url}}/whatsapp-bsp-api-endpoint-ws/services\")), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Token:\"), \" messaging token, in the \", mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"Authorization: Bearer {{wa-msg-api-token}}\"), \" header (\", mdx(\"a\", {\n    href: \"/whatsapp/authentication_token\"\n  }, \"how to generate it\"), \"). To create and manage groups (admin token), see \", mdx(\"a\", {\n    href: \"/whatsapp/administration/groups\"\n  }, \"Administration \\u2192 Groups\"), \".\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"strong\", {\n    parentName: \"li\"\n  }, \"Endpoints on this page:\"), mdx(\"ul\", {\n    parentName: \"li\"\n  }, mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"POST /v1/messaging\"), \": Send a message to a group\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"POST /v1/messaging\"), \": Pin a message in a group\"), mdx(\"li\", {\n    parentName: \"ul\"\n  }, mdx(\"inlineCode\", {\n    parentName: \"li\"\n  }, \"POST /v1/messaging\"), \": Unpin a message in a group\"))))), mdx(\"section\", {\n    \"id\": \"sendamessagetoagroup\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Send a message to a group\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"The request body is similar to a 1:1 conversation, plus the \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"recipient_type: \\\"group\\\"\"), \" property to indicate the recipient is a group. The supported message types for groups are: text, media (image, audio, video, document, sticker), template, and pin. Location, contacts, reaction and interactive messages \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"are not supported\"), \" for groups and return \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"RECIPIENT_TYPE_GROUP_NOT_SUPPORTED\"), \".\")), mdx(\"section\", {\n    \"id\": \"sendamessagetoagroup--request\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Request\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Send a message to a group\"), \" request:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"URL\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Method\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"POST\"))))), mdx(\"section\", {\n    \"id\": \"sendamessagetoagroup--headers\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Headers\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Send a message to a group\"), \" headers:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Content-Type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"application/json\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Authorization\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Messaging token in the format \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"Bearer {token}\"), \" (with one space). See \", mdx(\"a\", {\n    href: \"/whatsapp/authentication_token\"\n  }, \"Generate authentication token\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\"))))), mdx(\"section\", {\n    \"id\": \"sendamessagetoagroup--body\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Body\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Send a message to a group\"), \" body fields:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"recipient_type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Recipient type: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"group\\\"\"), \" if the message is sent to a group, or \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"individual\\\"\"), \" for a 1:1 conversation. Default: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"individual\\\"\"), \". Any other value returns \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"INVALID_RECIPIENT_TYPE\"), \". Accepted wire keys: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"recipient_type\"), \" (preferred) and the camelCase alias \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"recipientType\"), \"; both map to the same field.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Optional\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"messaging_product\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Messaging product identifier. Defaults to \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"whatsapp\\\"\"), \" and does not need to be sent \\u2014 the service always forwards \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"messaging_product: \\\"whatsapp\\\"\"), \" to Meta. Only include it to match Meta Cloud API payloads verbatim. Accepted wire keys: \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"messaging_product\"), \" and the camelCase alias \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"messagingProduct\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Optional\"))))), mdx(\"section\", {\n    \"id\": \"sendamessagetoagroup--example\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Example\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Complete \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Send a message to a group\"), \" example:\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-bash\"\n  }, \"curl --location 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \\\\\\n--header 'Authorization: Bearer {{wa-msg-api-token}}' \\\\\\n--header 'Content-Type: application/json' \\\\\\n--data '{\\n    \\\"from\\\": \\\"{{business_phone_number}}\\\",\\n    \\\"to\\\": \\\"{{group_id}}\\\",\\n    \\\"recipient_type\\\": \\\"group\\\",\\n    \\\"type\\\": \\\"text\\\",\\n    \\\"text\\\": \\\"Hello group!\\\"\\n}'\\n\"))), mdx(\"section\", {\n    \"id\": \"sendamessagetoagroup--response\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Response\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Send a message to a group\"), \" response:\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"All three messaging operations (send, pin, unpin) return the same response structure as 1:1 messages: the ID of the sent message.\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"id\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ID of the sent message.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\")))), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"[\\n  {\\n    \\\"id\\\": \\\"gBGHUhVUByKUHwIJ5zf2vjzVJh-X\\\"\\n  }\\n]\\n\")), mdx(\"br\", null), mdx(\"hr\", {\n    parentName: \"section\"\n  })), mdx(\"section\", {\n    \"id\": \"pinamessageinagroup\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Pin a message in a group\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Pins a message in the group to highlight it. Only the group admin can pin or unpin messages. Up to 3 messages can be pinned at a time; if 3 are already pinned, the oldest one is automatically unpinned.\")), mdx(\"section\", {\n    \"id\": \"pinamessageinagroup--request\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Request\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Pin a message in a group\"), \" request:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"URL\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Method\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"POST\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"application/json\"))))), mdx(\"section\", {\n    \"id\": \"pinamessageinagroup--headers\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Headers\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Pin a message in a group\"), \" headers:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Content-Type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"application/json\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Authorization\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Messaging token in the format \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"Bearer {token}\"), \" (with one space). See \", mdx(\"a\", {\n    href: \"/whatsapp/authentication_token\"\n  }, \"Generate authentication token\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\"))))), mdx(\"section\", {\n    \"id\": \"pinamessageinagroup--body\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Body\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Pin a message in a group\"), \" body fields:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"recipient_type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Recipient type. For groups, the value must be \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"group\\\"\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"to\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ID of the group where the message is pinned.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Message operation type. To pin or unpin, the value is \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"pin\\\"\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"pin.type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Operation to perform. To pin, the value is \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"pin\\\"\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"pin.message_id\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Unique ID of the message to pin.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"pin.expiration_days\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"How long the message stays pinned, in days (numeric string, e.g. \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"30\\\"\"), \"). The 1\\u201330 range is Meta's limit; this API only checks that the field is present, it does not validate the range.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required when pinning\"))))), mdx(\"section\", {\n    \"id\": \"pinamessageinagroup--example\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Example\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Complete \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Pin a message in a group\"), \" example:\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-bash\"\n  }, \"curl --location 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \\\\\\n--header 'Authorization: Bearer {{wa-msg-api-token}}' \\\\\\n--header 'Content-Type: application/json' \\\\\\n--data '{\\n    \\\"from\\\": \\\"{{business_phone_number}}\\\",\\n    \\\"to\\\": \\\"{{group_id}}\\\",\\n    \\\"recipient_type\\\": \\\"group\\\",\\n    \\\"type\\\": \\\"pin\\\",\\n    \\\"pin\\\": {\\n        \\\"type\\\": \\\"pin\\\",\\n        \\\"message_id\\\": \\\"{{pin_message_id}}\\\",\\n        \\\"expiration_days\\\": \\\"30\\\"\\n    }\\n}'\\n\"))), mdx(\"section\", {\n    \"id\": \"pinamessageinagroup--response\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Response\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Pin a message in a group\"), \" response:\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"All three messaging operations (send, pin, unpin) return the same response structure as 1:1 messages: the ID of the sent message.\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"id\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ID of the sent message.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\")))), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"[\\n  {\\n    \\\"id\\\": \\\"gBGHUhVUByKUHwIJ5zf2vjzVJh-X\\\"\\n  }\\n]\\n\")), mdx(\"br\", null), mdx(\"hr\", {\n    parentName: \"section\"\n  })), mdx(\"section\", {\n    \"id\": \"unpinamessageinagroup\"\n  }, mdx(\"h2\", {\n    parentName: \"section\"\n  }, \"Unpin a message in a group\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Unpins a previously pinned message. Only the group admin can unpin messages. It uses the same \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"\\\"pin\\\"\"), \" type, with the \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"\\\"unpin\\\"\"), \" operation in \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"pin.type\"), \"; unlike pinning, you don't send \", mdx(\"inlineCode\", {\n    parentName: \"p\"\n  }, \"expiration_days\"), \".\")), mdx(\"section\", {\n    \"id\": \"unpinamessageinagroup--request\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Request\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Unpin a message in a group\"), \" request:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"URL\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Method\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"POST\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"application/json\"))))), mdx(\"section\", {\n    \"id\": \"unpinamessageinagroup--headers\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Headers\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Unpin a message in a group\"), \" headers:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Content-Type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"application/json\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Authorization\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Messaging token in the format \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"Bearer {token}\"), \" (with one space). See \", mdx(\"a\", {\n    href: \"/whatsapp/authentication_token\"\n  }, \"Generate authentication token\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\"))))), mdx(\"section\", {\n    \"id\": \"unpinamessageinagroup--body\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Body\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Unpin a message in a group\"), \" body fields:\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Requirements\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"recipient_type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Recipient type. For groups, the value must be \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"group\\\"\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"to\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ID of the group where the message is unpinned.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Message operation type. To pin or unpin, the value is \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"pin\\\"\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"pin.type\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Operation to perform. To unpin, the value is \", mdx(\"inlineCode\", {\n    parentName: \"td\"\n  }, \"\\\"unpin\\\"\"), \".\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\")), mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"pin.message_id\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Unique ID of the message to unpin.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Required\"))))), mdx(\"section\", {\n    \"id\": \"unpinamessageinagroup--example\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Example\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"Complete \", mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Unpin a message in a group\"), \" example:\"), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-bash\"\n  }, \"curl --location 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \\\\\\n--header 'Authorization: Bearer {{wa-msg-api-token}}' \\\\\\n--header 'Content-Type: application/json' \\\\\\n--data '{\\n    \\\"from\\\": \\\"{{business_phone_number}}\\\",\\n    \\\"to\\\": \\\"{{group_id}}\\\",\\n    \\\"recipient_type\\\": \\\"group\\\",\\n    \\\"type\\\": \\\"pin\\\",\\n    \\\"pin\\\": {\\n        \\\"type\\\": \\\"unpin\\\",\\n        \\\"message_id\\\": \\\"{{pin_message_id}}\\\"\\n    }\\n}'\\n\"))), mdx(\"section\", {\n    \"id\": \"unpinamessageinagroup--response\"\n  }, mdx(\"h3\", {\n    parentName: \"section\"\n  }, \"Response\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, mdx(\"strong\", {\n    parentName: \"p\"\n  }, \"Unpin a message in a group\"), \" response:\"), mdx(\"p\", {\n    parentName: \"section\"\n  }, \"All three messaging operations (send, pin, unpin) return the same response structure as 1:1 messages: the ID of the sent message.\"), mdx(\"table\", {\n    parentName: \"section\"\n  }, mdx(\"thead\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"thead\"\n  }, mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Name\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Description\"), mdx(\"th\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"Type\"))), mdx(\"tbody\", {\n    parentName: \"table\"\n  }, mdx(\"tr\", {\n    parentName: \"tbody\"\n  }, mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"id\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"ID of the sent message.\"), mdx(\"td\", {\n    parentName: \"tr\",\n    \"align\": null\n  }, \"String\")))), mdx(\"pre\", {\n    parentName: \"section\"\n  }, mdx(\"code\", {\n    parentName: \"pre\",\n    \"className\": \"language-json\"\n  }, \"[\\n  {\\n    \\\"id\\\": \\\"gBGHUhVUByKUHwIJ5zf2vjzVJh-X\\\"\\n  }\\n]\\n\")), mdx(\"br\", null)));\n}\n;\nMDXContent.isMDXComponent = true;","tableOfContents":{"items":[{"url":"#send-a-message-to-a-group","title":"Send a message to a group","items":[{"url":"#request","title":"Request"},{"url":"#headers","title":"Headers"},{"url":"#body","title":"Body"},{"url":"#example","title":"Example"},{"url":"#response","title":"Response"}]},{"url":"#pin-a-message-in-a-group","title":"Pin a message in a group","items":[{"url":"#request-1","title":"Request"},{"url":"#headers-1","title":"Headers"},{"url":"#body-1","title":"Body"},{"url":"#example-1","title":"Example"},{"url":"#response-1","title":"Response"}]},{"url":"#unpin-a-message-in-a-group","title":"Unpin a message in a group","items":[{"url":"#request-2","title":"Request"},{"url":"#headers-2","title":"Headers"},{"url":"#body-2","title":"Body"},{"url":"#example-2","title":"Example"},{"url":"#response-2","title":"Response"}]}]},"timeToRead":1,"parent":{"__typename":"File","relativePath":"whatsapp/messaging/groups.md","fields":{"gitLogLatestAuthorName":"Irais Aguirre","gitLogLatestAuthorEmail":"irais.aguirre@conceptomovil.com","gitLogLatestDate":"6 hours ago"}},"frontmatter":{"metaTitle":null,"showMetadata":null,"editable":null,"showPreviousNext":null,"showToc":null}},"gitBranch":{"name":"20211019-2FACTOR_AUTH"},"gitCommit":{"hash":"9713e1925aeb8cad930f91b6bf05d0b5937b2bb5","date":"2026-11-13 06:39"}},"pageContext":{"id":"9e228a38-1837-5151-b99e-2678ec5a37b4"}},"staticQueryHashes":["12478684","12478684","2882937274","2882937274","353167761","353167761"]}