---
updatedAt: 2026-02-10T12:06:54.000Z
agentTools:
  projectIndex: https://developer-docs.rivo.io/llms.txt
---

# membership/canceled

Triggered when a customer's paid membership is immediately canceled via a cancellation request. If the cancellation policy is end_of_period, the membership/pending_cancellation webhook is triggered instead

## Event Type

```
membership/canceled
```

***

## Webhook Payload

```json
{
  "id": 7343536570439,
  "email": "customer@example.com",
  "first_name": "John",
  "last_name": "Doe",
  "dob": "06-30",
  "dob_last_updated_at": "2024-01-15T10:30:00Z",
  "accepts_marketing": false,
  "orders_count": 0,
  "verified_email": false,
  "total_spent": 0,
  "shopify_tags": [],
  "loyalty_status": "member",
  "loyalty_status_last_changed_at": "2024-01-15T10:30:00Z",
  "points_tally": 56348,
  "credits_tally": "0.0",
  "referral_url": "https://shop.com/ref/ABC123",
  "referral_code": "ABC123",
  "vip_tier": {
    "id": 1,
    "name": "Gold",
    "threshold": 10000,
    "perks": [],
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z"
  },
  "points_expire_at": "December 31, 2024",
  "remote_updated_at": "2024-01-15T10:30:00Z",
  "event_type": "membership/canceled",
  "event_attributes": {
    "customer_id": 7343536570439,
    "last_subscription_contract_id": 123123123123,
    "cancelled_at": "2024-01-15T10:30:00Z"
  }
}

 
```

***

## Payload Fields

| Field                                            | Type             | Description                                                      |
| :----------------------------------------------- | :--------------- | :--------------------------------------------------------------- |
| `id`                                             | Integer          | Customer ID (Shopify remote ID)                                  |
| `email`                                          | String           | Customer email address                                           |
| `first_name`                                     | String           | Customer's first name                                            |
| `last_name`                                      | String           | Customer's last name                                             |
| `dob`                                            | Date or null     | Customer's date of birth, if provided                            |
| `dob_last_updated_at`                            | DateTime or null | Timestamp of when the date of birth was last updated             |
| `accepts_marketing`                              | Boolean          | Shopify email subscriber status (`true` if opted in)             |
| `orders_count`                                   | Integer          | Total number of orders placed                                    |
| `verified_email`                                 | Boolean          | Whether the customer's email address is verified                 |
| `total_spent`                                    | Float            | Total amount the customer has spent                              |
| `shopify_tags`                                   | Array of strings | List of Shopify tags associated with the customer                |
| `loyalty_status`                                 | String           | Current loyalty program status (e.g. `member`, `guest`)          |
| `loyalty_status_last_changed_at`                 | DateTime or null | Timestamp of the last loyalty status change                      |
| `points_tally`                                   | Integer          | Current points balance                                           |
| `credits_tally`                                  | Float            | Current credits balance                                          |
| `referral_url`                                   | String           | Customer's unique referral URL                                   |
| `referral_code`                                  | String           | Customer's unique referral code                                  |
| `vip_tier`                                       | Object or null   | Customer's current VIP tier, if applicable                       |
| `vip_tier.id`                                    | Integer          | VIP tier ID                                                      |
| `vip_tier.name`                                  | String           | VIP tier name                                                    |
| `vip_tier.threshold`                             | Integer          | Points threshold for the tier                                    |
| `vip_tier.perks`                                 | Array            | List of perks associated with the tier                           |
| `vip_tier.created_at`                            | DateTime         | Tier creation timestamp                                          |
| `vip_tier.updated_at`                            | DateTime         | Tier last updated timestamp                                      |
| `points_expire_at`                               | String or null   | Date when the customer's points expire                           |
| `remote_updated_at`                              | DateTime         | Timestamp of the last update from Shopify                        |
| `event_type`                                     | String           | Always `membership/canceled` for this webhook                    |
| `event_attributes`                               | Object           | Event-specific data for the cancellation                         |
| `event_attributes.customer_id`                   | Integer          | Customer ID associated with the cancellation request             |
| `event_attributes.last_subscription_contract_id` | Integer          | Remote ID of the customer's last cancelled subscription contract |
| `event_attributes.cancelled_at`                  | DateTime         | Timestamp when the cancellation occurred                         |

<br />