---
title: "Subscription From Order"
method: POST
path: "/api/v1/subscriptions/from-order"
tags: ["subscriptions", "subscriptions"]
---

# Subscription From Order

`POST /api/v1/subscriptions/from-order`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/subscriptions/from-order`
- Auth: API key in header `X-API-Key`

## Headers

- `X-Claim-Token` string, nullable

## Request body

- FromOrderRequest: Get new matches on a paid list order. `session_id` (the order's Stripe Checkout session, as the success page holds it) or the list's X-Claim-Token header is the bearer — the same two secrets the receipt already trusts.
  - `order_id` string, required
  - `cadence` 'daily' | 'weekly' | 'monthly' | 'quarterly'
  - `cap_cents` integer, nullable
  - `lane` 'all' | 'best' | 'contact', nullable
  - `run_days` integer, nullable
  - `contact` 'any' | 'email' | 'phone' | 'both'
  - `session_id` string, nullable
  - `success_url` string, nullable
  - `cancel_url` string, nullable
  - `test_mode` boolean

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)