---
title: "Apply Sailthru tagging on checkout success"
method: POST
path: "/users/checkout-success-callback"
tags: ["Account"]
---

# Apply Sailthru tagging on checkout success

`POST /users/checkout-success-callback`

## Request

- Base URL: `http://dev.theverge.com:3002/api`
- URL: `http://dev.theverge.com:3002/api/users/checkout-success-callback`
- Auth: none declared

On checkout success, sets `plan_coupon` in Sailthru for all users. If the promo code matches the server-side allowlist, also enrolls the user in the configured Sailthru lists and sets additional vars. Identity is taken only from the session (logged-in user).

## Request body

- object
  - `promoCode` string

## Response `200`

No promo code provided (skipped), or Sailthru tagging was applied (updated).

- object
  - `data` CheckoutSuccessCallbackResponse, required
    - `ok` boolean, required
    - `status` 'skipped' | 'updated', required

## Other responses

- `400`: Invalid input parameters
- `401`: Unauthorized access
- `500`: Internal server error

---

[API](https://skmtc.dev/theverge/apis/the-verge-api-documentation.md) - [All operations](https://skmtc.dev/theverge/apis/the-verge-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/theverge/apis/the-verge-api-documentation/revisions/f44a9b8ebfc3?raw)