---
title: "End a max delivery or creative boost session"
method: DELETE
path: "/gmv-max/campaigns/{campaign_id}/sessions/{session_id}"
tags: ["GMV Max"]
---

# End a max delivery or creative boost session

`DELETE /gmv-max/campaigns/{campaign_id}/sessions/{session_id}`

## Request

- Base URL: `https://api.reacherapp.com/public/v1`
- URL: `https://api.reacherapp.com/public/v1/gmv-max/campaigns/{campaign_id}/sessions/{session_id}`
- Auth: API key in header `x-api-key` and API key in header `x-shop-id`

TikTok's `campaign/gmv_max/session/delete`: stops the session's extra spend now. The session must be on this campaign, which must be on this shop's store; a session a Reacher automation runs is refused (409) — stop that automation instead. Requires `read_write` scope. Idempotent via `Idempotency-Key`; `X-Dry-Run: true` runs the checks only. Single shop only.

## Path parameters

- `campaign_id` string, required
- `session_id` string, required

## Headers

- `Idempotency-Key` string, nullable
- `X-Dry-Run` string, nullable
- `X-Created-Via` string, nullable

## Response `200`

Successful Response

- GmvMaxSessionWriteResponse: Session create, update and delete. With ``X-Dry-Run: true`` nothing is sent and ``would`` holds the TikTok body.
  - `campaign_id` string, required
  - `session_id` string, nullable: The session written (TikTok's id, on create).
  - `action` 'created' | 'updated' | 'deleted', required
  - `dry_run` boolean, nullable: True when nothing was sent to TikTok.
  - `would` object, nullable: Dry run only: the TikTok request body.

## Other responses

- `400`: Invalid request / shop not connected to GMV Max.
- `403`: API key lacks `read_write` scope (`FORBIDDEN`), or the shop's TikTok authorization lacks this permission (`TIKTOK_PERMISSION_MISSING`).
- `404`: Campaign or session not found in this shop.
- `409`: Idempotency-Key conflict, or a Reacher automation runs the session.
- `422`: TikTok rejected the write; the message says why.
- `429`: Write rate limit exceeded, or TikTok is throttling.
- `502`: TikTok failed transiently; safe to retry.

## Changes

> 76 revisions in range; 1 not diffed.

- **2026-10-18** `17e0890869d5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/gmv-max/campaigns/:campaign_id/sessions/:session_id/delete.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) - [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/63ce74b30b5a?raw)