---
title: "Update Customer Activation"
method: PUT
path: "/api/v4.0/integrations/customers/{customerId}/activate"
tags: ["Customers"]
---

# Update Customer Activation

`PUT /api/v4.0/integrations/customers/{customerId}/activate`

Set a customer's loyalty program participation state (active/inactive). This mirrors the include/exclude toggle in the Gameball dashboard.

The endpoint is idempotent: opting out an already opted-out customer (or opting in an already opted-in customer) produces no side effects. `stateChanged` indicates whether the state actually changed.

When a customer is opted out (`isActive: false`): no points are earned from events or purchases, no rewards or coupons are generated, and the customer is excluded from all campaign eligibility. Prior activity is not undone.

**Security:** Requires `apiKey` header. `secretKey` is required on v4.1; on v4.0 required when High Security Mode is enabled.

**Requires an existing customer.** Unknown customers return `404 Not Found`.

## Path parameters

- `customerId` string, required

## Request body

- object
  - `isActive` boolean, required — Set to `true` to opt the customer in (Include); set to `false` to opt the customer out (Exclude).

## Response `200`

Customer activation state updated (or already in the requested state)

- object
  - `customerId` string — Echo of the customer ID from the request.
  - `isActive` boolean — The customer's activation state after this request.
  - `stateChanged` boolean — `true` if the state was different before this request and changed as a result; `false` if the customer was already in the target state (idempotent no-op).

## Other responses

- `400` — Missing or invalid request payload (e.g. missing `isActive`), or a concurrent request for this customer is in progress.
- `401` — Missing, invalid, or expired API key; or invalid secret key (when required).
- `404` — Customer does not exist in your Gameball account, or customer ID is malformed.

---

[API](https://skmtc.net/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.net/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gameballers/gameball-api/revisions/3b11e1670d61/schema)