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

# Subscription From List

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

## 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-list`
- Auth: API key in header `X-API-Key`

## Headers

- `X-Claim-Token` string, nullable

## Request body

- FromListRequest: Get new matches on a saved list the buyer has not bought. The first delivery is new matches from creation on — never the list as it stands.
  - `list_id` string, required
  - `email` string, required
  - `claim_token` string, nullable
  - `cadence` 'daily' | 'weekly' | 'monthly' | 'quarterly'
  - `cap_cents` integer, required
  - `lane` 'all' | 'best' | 'contact'
  - `delivery` 'file' | 'crm'
  - `crm_connection_id` string, nullable
  - `run_days` integer, nullable
  - `contact` 'any' | 'email' | 'phone' | 'both'
  - `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)