HeyClaude Newsletter API
The Newsletter API from HeyClaude — 4 operation(s) for newsletter.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/heyclau-de:heyclau-de-newsletter-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: HeyClaude Newsletter API
version: 1.0.0
description: Read-only registry, distribution feeds, and tightly scoped dynamic endpoints. Public registry publishing is not exposed through the API.
servers:
- url: https://heyclau.de
security:
- OriginCheck: []
tags:
- name: Newsletter
paths:
/api/newsletter/subscribe:
post:
tags:
- Newsletter
summary: Subscribe an email to the newsletter
requestBody:
content:
application/json:
schema:
type: object
properties:
email:
type: string
maxLength: 320
segments:
type: array
items:
type: string
minLength: 1
maxLength: 64
pattern: ^[a-z0-9:_-]+$/i
maxItems: 20
default: []
source:
type: string
maxLength: 64
default: site
required:
- email
responses:
'200':
description: Request accepted.
content:
application/json:
schema:
type: object
additionalProperties: {}
'400':
description: Invalid JSON, invalid query, invalid payload, or invalid status transition.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'401':
description: Unauthorized admin token or invalid webhook signature.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'403':
description: Forbidden origin.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'413':
description: Payload too large.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'415':
description: Invalid content type.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'429':
description: Route-level or Cloudflare-native rate limited.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'500':
description: Internal error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'502':
description: Upstream provider error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'503':
description: Site DB not configured, provider not configured, or endpoint unavailable.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
operationId: postApiNewsletterSubscribe
x-operation-id-source: derived
/api/public/newsletter/confirm:
post:
tags:
- Newsletter
summary: Confirm a newsletter subscription
requestBody:
content:
application/json:
schema:
type: object
properties:
token:
type: string
minLength: 1
maxLength: 4096
required:
- token
responses:
'200':
description: Request accepted.
content:
application/json:
schema:
type: object
additionalProperties: {}
'400':
description: Invalid JSON, invalid query, invalid payload, or invalid status transition.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'401':
description: Unauthorized admin token or invalid webhook signature.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'403':
description: Forbidden origin.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'413':
description: Payload too large.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'415':
description: Invalid content type.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'429':
description: Route-level or Cloudflare-native rate limited.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'500':
description: Internal error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'502':
description: Upstream provider error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'503':
description: Site DB not configured, provider not configured, or endpoint unavailable.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
operationId: postApiPublicNewsletterConfirm
x-operation-id-source: derived
/api/public/newsletter/unsubscribe:
post:
tags:
- Newsletter
summary: Unsubscribe an email from newsletter segments
requestBody:
content:
application/json:
schema:
type: object
properties:
email:
type: string
maxLength: 320
segments:
type: array
items:
type: string
minLength: 1
maxLength: 64
pattern: ^[a-z0-9:_-]+$/i
maxItems: 20
default: []
required:
- email
responses:
'200':
description: Request accepted.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- true
required:
- ok
'400':
description: Invalid JSON, invalid query, invalid payload, or invalid status transition.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'401':
description: Unauthorized admin token or invalid webhook signature.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'403':
description: Forbidden origin.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'413':
description: Payload too large.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'415':
description: Invalid content type.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'429':
description: Route-level or Cloudflare-native rate limited.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'500':
description: Internal error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'502':
description: Upstream provider error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'503':
description: Site DB not configured, provider not configured, or endpoint unavailable.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
operationId: postApiPublicNewsletterUnsubscribe
x-operation-id-source: derived
/api/newsletter/webhook:
post:
tags:
- Newsletter
summary: Receive Resend webhook events
responses:
'200':
description: Request accepted.
content:
application/json:
schema:
type: object
additionalProperties: {}
'400':
description: Invalid JSON, invalid query, invalid payload, or invalid status transition.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'401':
description: Unauthorized admin token or invalid webhook signature.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'403':
description: Forbidden origin.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'413':
description: Payload too large.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'415':
description: Invalid content type.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'429':
description: Route-level or Cloudflare-native rate limited.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'500':
description: Internal error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'502':
description: Upstream provider error.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
'503':
description: Site DB not configured, provider not configured, or endpoint unavailable.
content:
application/json:
schema:
type: object
properties:
ok:
type: boolean
enum:
- false
error:
type: object
properties:
code:
type: string
minLength: 1
message:
type: string
details: {}
required:
- code
requestId:
type: string
required:
- ok
- error
operationId: postApiNewsletterWebhook
x-operation-id-source: derived