---
title: "Service: /groups/{group}/unsubscribe [POST]"
source: https://dev.pageseeder.com/api/services/unsubscribe-POST.html
description: "POST endpoint for unsubscribing a member from a group without login. Optionally modifies notification settings or removes member from groups. Requires a valid unsubscribe token. Returns membership details in XML format."
last_updated: 2026-09-02T11:36:07+10:00
document_type: api_endpoint
operation_id: membership-POST
resource_id: membership
path_template: /groups/{group}/unsubscribe
http_method: POST
api_category: membership
implementation_version: 6.2005
api_since: 5.9300
deprecated_since: null
obsolete_since: null
api_support: supported
cache_control: N/A
generated_at: 2026-09-02
tokens: ~442
---

# /groups/\{group\}/unsubscribe \[POST\]

## Description

Unsubscribe a [member](../../reference/glossary/member.md) from a [group](../../reference/glossary/group.md) without logging in.

Optionally changes a member’s [notification](../../reference/glossary/notification.md) settings or removes them from one or more groups. Returns a list of group and [subgroup](../../reference/glossary/subgroup.md) memberships for a member for the group specified.

## Parameters

| Name | Description | Required | Type | Default |
| --- | --- | --- | --- | --- |
| deregister | If `true`, remove the user from the group or subgroups | no | boolean | false |
| notification | The members notification option for the group or subgroups (`immediate\|daily\|weekly\|essential\|none`) | no | string |  |
| token | Unsubscribe token for the group and member | yes | string |  |

## Permission

A valid token for the group and member can invoke this service.

## Response

The XML returned is one or more `<membership>` elements inside an `<unsubscribe>` element:

```xml

<unsubscribe email="[member's email]">
  <membership id="[membership id]"
              email-listed="[true|false]"
              notification="[notification]"
              flags="[flags]"
              status="normal"
              role="[role]"
              [subgroups="[subgroups]"]
              [override="[overridden attributes]"]>
    <group|project id="[group id]"
                   name="[group name]"
                   description="[description]"
                   owner="[owner]"
                   [relatedurl="[url]"] />
  </membership>
  <membership ...> ... </membership>
  ...
</unsubscribe>
 
```

## Error Handling

| 0x102A | Token is invalid |
| --- | --- |
| 0x102B | Token has expired |