Zum Inhalt springen
Funktioniert mit Claude & ChatGPT

Sayweek API

Alles, was Sayweek plant, schreibt und einplant – aus deinem eigenen Code, n8n, Zapier, Make oder einem KI-Assistenten. Schreibzugriffe legen Entwürfe an, die auf Freigabe warten, damit nichts versehentlich öffentlich wird.

Basis-URL: https://app.sayweek.com/api/v1

Erste Schritte

  1. Token holen

    Einstellungen → Integrationen → REST-API → „Neuer API-Schlüssel“. Wähle die Berechtigungen; der Schlüssel wird nur einmal angezeigt.

  2. Erster Aufruf

    GET /me antwortet mit dem Workspace und den Berechtigungen – der schnellste Weg, den Token zu prüfen.

  3. Loslegen

    Entwürfe anlegen, die Woche lesen oder Webhooks abonnieren. Freigeben bleibt eine menschliche Entscheidung, außer du erlaubst es.

Deine erste Anfrage

curl
curl https://app.sayweek.com/api/v1/me \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
{
  "workspace": {
    "id": "w1",
    "name": "Acme Studio"
  },
  "auth": {
    "type": "api_key",
    "label": "CRM",
    "prefix": "pp_AbCd"
  },
  "user": null,
  "scopes": [
    "read",
    "write"
  ],
  "granted_scopes": [
    "read",
    "write"
  ],
  "webhook_events": [
    "post.created",
    "post.approved"
  ]
}

Authentifizierung

Sende jede Anfrage mit einem Authorization: Bearer-Header. Zwei Arten von Token funktionieren überall in /api/v1:

API-Schlüssel (pp_…)

Für eigene Skripte und Server. In den Einstellungen erstellt, an den Workspace gebunden, Berechtigungen beim Erstellen gewählt. Jederzeit widerrufbar.

OAuth-Access-Token (sw_at_…)

Für Apps, die andere verbinden („Mit Sayweek verbinden“). 1 Stunde gültig, erneuerbar, im Namen des Mitglieds, das zugestimmt hat – dessen Rolle gilt weiterhin.

Sayweek speichert Schlüssel und Tokens nur als Hash. Ein Token ist durchgesickert? Widerrufe ihn in den Einstellungen – er funktioniert sofort nicht mehr.

OAuth-Apps

Authorization-Code-Flow mit PKCE (S256) – für Server-Apps, Single-Page-Apps, mobile Apps und CLIs gleichermaßen.

  1. App registrieren

    Einstellungen → Integrationen → REST-API → OAuth-Apps: Name, Logo, Weiterleitungs-URLs und die Berechtigungen, die sie anfragen darf. Server-Apps bekommen ein Client-Secret; öffentliche Clients nutzen nur PKCE.

  2. Nutzer zur Zustimmung schicken

    Erzeuge einen zufälligen code_verifier und sende seinen SHA-256-Hash (base64url) als code_challenge. Der Nutzer sieht deinen Namen, dein Logo und die genauen Berechtigungen – in seiner Sprache.

  3. Code einlösen

    POST /api/oauth/token mit grant_type=authorization_code, dem Code, redirect_uri und code_verifier (+ client_secret bei Server-Apps).

  4. Erneuern und widerrufen

    Access-Tokens gelten 1 Stunde. Erneuere mit grant_type=refresh_token – der Refresh-Token wechselt bei jeder Nutzung. POST /api/oauth/revoke beendet die Verbindung.

# 1) PKCE: a random verifier and its S256 challenge
CODE_VERIFIER=$(openssl rand -base64 48 | tr -d '=+/' | cut -c1-64)
CODE_CHALLENGE=$(printf '%s' "$CODE_VERIFIER" | openssl dgst -sha256 -binary | openssl base64 | tr '+/' '-_' | tr -d '=')

# 2) Send the user here (they see your app's name, logo and the scopes)
open "https://app.sayweek.com/oauth/authorize?response_type=code&client_id=$CLIENT_ID\
&redirect_uri=https%3A%2F%2Fapp.example.com%2Fcallback&scope=read%20write\
&state=$STATE&code_challenge=$CODE_CHALLENGE&code_challenge_method=S256"

Discovery: /.well-known/oauth-authorization-server. Die dynamische Client-Registrierung (RFC 7591) ist für KI-Assistenten offen; Partner-Apps solltest du in den Einstellungen registrieren, damit Name und Logo auf der Zustimmungsseite erscheinen.

Berechtigungen

Ein Token kann nur, was seine Berechtigungen erlauben – und nie mehr als die Rolle des Mitglieds und der Tarif des Workspace.

  • read

    Marken, Kanäle, Wochenplan, Posts, Ideen, Kalender-Übersicht, Statistik.

  • write

    Entwürfe und Ideen schreiben und bearbeiten, eine Woche generieren, nicht gesendete Posts löschen, die eigenen Webhooks des Tokens verwalten.

  • approve

    Freigeben = wirklich einplanen. Muss auch im Workspace erlaubt sein; alle Freigaberegeln gelten.

Solo: nur read. Pro, Team und Agency: auch write und approve.

Endpunkte

Aus der OpenAPI-Beschreibung erzeugt, passt also immer zur API. Jede Anfrage braucht einen Bearer-Token.

Marken & Kanäle

GET/brandsread

Marken mit ihren Kanälen

Parameter
limitquery1–200, Standard 50
cursorquerynext_cursor der vorigen Seite
curl "https://app.sayweek.com/api/v1/brands" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
Beispielantwort
{
  "data": [
    {
      "id": "b1",
      "name": "Acme Studio",
      "color": "#2563eb",
      "language": "en",
      "country": "GB",
      "is_business": true,
      "channels": [
        {
          "id": "0b6a5c4d-2e1f-4a3b-9c8d-7e6f5a4b3c2d",
          "name": "Acme on LinkedIn",
          "platform": "linkedin"
        }
      ]
    }
  ],
  "next_cursor": null
}
GET/channelsread

Kanäle

Parameter
brand_idqueryNur diese Marke
limitquery1–200, Standard 50
cursorquerynext_cursor der vorigen Seite
curl "https://app.sayweek.com/api/v1/channels" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"

Posts

GET/postsread

Posts auflisten

Parameter
fromqueryJJJJ-MM-TT, Standard heute
toqueryJJJJ-MM-TT, Standard from + 30 Tage (max. 366)
statusqueryKommagetrennt: idea,draft,queued,approved,published,error
brand_idqueryNur diese Marke
channel_idqueryNur dieser Kanal
limitquery1–200, Standard 50
cursorquerynext_cursor der vorigen Seite
curl "https://app.sayweek.com/api/v1/posts?from=2026-10-12&to=2026-10-18&status=draft%2Capproved" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/postswrite

Entwurf anlegen (veröffentlicht nie)

Parameter
Idempotency-KeyheaderSpielt 24 Stunden lang die erste Antwort erneut aus (gleicher Schlüssel + gleiche Anfrage)
curl -X POST "https://app.sayweek.com/api/v1/posts" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"0b6a5c4d-2e1f-4a3b-9c8d-7e6f5a4b3c2d","date":"2026-10-13","time":"09:30","text":"Three things a year of weekly posting taught us…","hashtags":["#marketing"]}'
Request-Body
{
  "channel_id": "0b6a5c4d-2e1f-4a3b-9c8d-7e6f5a4b3c2d",
  "date": "2026-10-13",
  "time": "09:30",
  "text": "Three things a year of weekly posting taught us…",
  "hashtags": [
    "#marketing"
  ]
}
Beispielantwort
{
  "id": "6f1c2b0e-3a4d-4c5e-9f60-1a2b3c4d5e6f",
  "status": "draft",
  "date": "2026-10-13",
  "time": "09:30",
  "timezone": "Europe/London",
  "channel": {
    "id": "0b6a5c4d-2e1f-4a3b-9c8d-7e6f5a4b3c2d",
    "name": "Acme on LinkedIn",
    "platform": "linkedin"
  },
  "text": "Three things a year of weekly posting taught us…",
  "hashtags": [
    "#marketing"
  ],
  "submitted_for_approval": false
}
GET/posts/{id}read

Ein Post (mit Freigabeprüfung)

Parameter
idpathPflichtID (UUID)
curl "https://app.sayweek.com/api/v1/posts/6f1c2b0e-3a4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
PATCH/posts/{id}write

Text oder Termin eines noch nicht freigegebenen Posts ändern

Parameter
idpathPflichtID (UUID)
curl -X PATCH "https://app.sayweek.com/api/v1/posts/6f1c2b0e-3a4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Three things a year of weekly posting taught us (and one we unlearned).","time":"10:00"}'
Request-Body
{
  "text": "Three things a year of weekly posting taught us (and one we unlearned).",
  "time": "10:00"
}
DELETE/posts/{id}write

Post löschen (keine veröffentlichten; freigegebene brauchen `approve`)

Parameter
idpathPflichtID (UUID)
curl -X DELETE "https://app.sayweek.com/api/v1/posts/6f1c2b0e-3a4d-4c5e-9f60-1a2b3c4d5e6f" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/posts/{id}/approveapprove

Freigeben – plant den Post wirklich ein

Braucht die Berechtigung `approve` und Einstellungen → Integrationen → KI-Assistenten → „Freigaben erlauben“. Alle Freigaberegeln gelten; bei zweistufiger Freigabe reicht ein Nicht-Inhaber den Post nur ein.

Parameter
idpathPflichtID (UUID)
Idempotency-KeyheaderSpielt 24 Stunden lang die erste Antwort erneut aus (gleicher Schlüssel + gleiche Anfrage)
curl -X POST "https://app.sayweek.com/api/v1/posts/6f1c2b0e-3a4d-4c5e-9f60-1a2b3c4d5e6f/approve" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
Beispielantwort
{
  "result": "scheduled",
  "post": {
    "id": "6f1c2b0e-3a4d-4c5e-9f60-1a2b3c4d5e6f",
    "status": "queued"
  }
}
DELETE/posts/{id}/approveapprove

Freigabe zurücknehmen (Rückgängig)

Ein freigegebener oder eingereihter Post wird wieder ein Entwurf (`result: revoked`): die Planung in Postiz oder in Sayweeks eigener Warteschlange wird gelöscht, noch nicht gesendete Cross-Posts auch. Bei einem Entwurf, den die Freigabe einer Nicht-Inhaberin bzw. eines Nicht-Inhabers nur den Inhabern vorgelegt hat, wird die Vorlage zurückgezogen (`result: withdrawn`). Ein veröffentlichter oder gerade gesendeter Post (TikTok / YouTube in Verarbeitung, ein Thread-Teil draußen) ergibt 409; gibt es nichts zurückzunehmen, 422. Gleiche Berechtigung und gleicher Workspace-Schalter wie beim Freigeben.

Parameter
idpathPflichtID (UUID)
curl -X DELETE "https://app.sayweek.com/api/v1/posts/{id}/approve" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/posts/{id}/photowrite

Foto eines Posts aus einem Bild setzen

Ersetzt das (erste) Foto des Posts durch das angegebene JPEG, PNG oder WebP (base64 in `image`, höchstens 3 MB Bilddaten; EXIF- und Standortdaten entfernt, neu kodiert) und markiert die offene Fotoaufgabe des Posts als erledigt. Gleiche Statusregel wie im Editor: Entwürfe, und ein freigegebener Post bis kurz vor dem Erscheinen (er wird mit dem Planer neu abgeglichen; dafür braucht es auch die Berechtigung `approve`); sonst 409. `undo` ist nur gesetzt, wenn der Post kein Foto hatte und noch nicht eingeplant ist.

Parameter
idpathPflichtID (UUID)
Idempotency-KeyheaderSpielt 24 Stunden lang die erste Antwort erneut aus (gleicher Schlüssel + gleiche Anfrage)
curl -X POST "https://app.sayweek.com/api/v1/posts/{id}/photo" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Request-Body
{}
DELETE/posts/{id}/photowrite

Hochgeladenes Foto zurücknehmen

Entfernt das per `media_id` angegebene Foto (aus dem `undo` des Uploads), solange der Post nicht eingeplant ist, und öffnet seine Fotoaufgabe wieder. 409, wenn der Post eingeplant oder veröffentlicht ist oder das Foto inzwischen ersetzt wurde.

Parameter
idpathPflichtID (UUID)
media_idqueryundo.media_id des Uploads
curl -X DELETE "https://app.sayweek.com/api/v1/posts/{id}/photo" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/posts/{id}/movewrite

Post auf einen anderen Tag oder eine andere Zeit verschieben (wie im Kalender)

Gib `date` (+ `time`) an – die Ortszeit der Autorin oder des Autors an dem Tag, wie im Kalender –, oder mit `timezone` (die Zone des Geräts, umgerechnet), oder einen genauen `scheduled_at` mit Offset. Eine Uhrzeit, die es in der Zone nicht gibt (Sommerzeit-Lücke), wird abgelehnt. Bei Regelkonflikten (ein Post pro Tag, zu nah, falscher Tag, zu viele, gesperrter Tag) kommt `moved: false` mit `warnings`; mit `force: true` erneut senden, um zu bestätigen. Bei einem veröffentlichten, gerade gesendeten oder vergangenen Ziel kommt `moved: false` mit `block`. Freigegebene oder eingereihte Posts werden auch in Postiz verschoben und brauchen die Berechtigung `approve`. `If-Match: "<updated_at>"` macht das Verschieben bedingt (409, wenn sich der Post geändert hat).

Parameter
idpathPflichtID (UUID)
If-Matchheaderupdated_at des Posts, in Anführungszeichen
curl -X POST "https://app.sayweek.com/api/v1/posts/{id}/move" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Request-Body
{}

Ideen

GET/ideasread

Die Ideenbox

Parameter
statusquerynew (Standard), placed, dismissed, all
limitquery1–200, Standard 50
cursorquerynext_cursor der vorigen Seite
curl "https://app.sayweek.com/api/v1/ideas?status=new" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/ideaswrite

Idee hinzufügen

Parameter
Idempotency-KeyheaderSpielt 24 Stunden lang die erste Antwort erneut aus (gleicher Schlüssel + gleiche Anfrage)
curl -X POST "https://app.sayweek.com/api/v1/ideas" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"A customer asked how we price small retainers – worth a post."}'
Request-Body
{
  "text": "A customer asked how we price small retainers – worth a post."
}
Beispielantwort
{
  "ok": true,
  "id": "c2d3e4f5-0a1b-4c2d-8e3f-405162738495",
  "text": "A customer asked how we price small retainers – worth a post.",
  "status": "new",
  "suggestions": []
}

Planung & Generierung

GET/weekread

Wochenplan: jeder Slot mit seinem Post

Parameter
startqueryEin beliebiger Tag der Woche (Standard: diese Woche)
brand_idqueryNur diese Marke
curl "https://app.sayweek.com/api/v1/week?start=2026-10-12" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/generatewrite

Entwürfe für einen Zeitraum generieren (asynchron)

Legt für jeden freien Slot einen Entwurf in die Warteschlange (Standard: nächster Montag–Sonntag) und gibt einen Auftrag zurück. Abfragen mit GET /jobs/{id}.

Parameter
Idempotency-KeyheaderSpielt 24 Stunden lang die erste Antwort erneut aus (gleicher Schlüssel + gleiche Anfrage)
curl -X POST "https://app.sayweek.com/api/v1/generate" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-10-12","to":"2026-10-18"}'
Request-Body
{
  "from": "2026-10-12",
  "to": "2026-10-18"
}
Beispielantwort
{
  "id": "a1b2c3d4-0000-4000-8000-000000000001",
  "status": "queued",
  "from": "2026-10-12",
  "to": "2026-10-18",
  "total": 5,
  "done": 0,
  "failed": 0,
  "pending": 5,
  "skipped": 0,
  "posts": []
}
GET/jobs/{id}read

Status eines Generierungsauftrags

Parameter
idpathPflichtID (UUID)
curl "https://app.sayweek.com/api/v1/jobs/a1b2c3d4-0000-4000-8000-000000000001" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"

Kalender & Statistik

GET/calendar/sourcesread

Verbundene Kalender und was Sayweek daraus ableitet (Stadt, Art des Tages)

Parameter
daysquery1–60, Standard 14
curl "https://app.sayweek.com/api/v1/calendar/sources?days=14" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
GET/analytics/summaryread

Statistik-Übersicht

Parameter
daysquery7, 30 (Standard) oder 90
curl "https://app.sayweek.com/api/v1/analytics/summary?days=30" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"

Konto & Webhooks

GET/meread

Wem dieser Token gehört (Verbindung testen)

curl "https://app.sayweek.com/api/v1/me" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
Beispielantwort
{
  "workspace": {
    "id": "w1",
    "name": "Acme Studio"
  },
  "auth": {
    "type": "api_key",
    "label": "CRM",
    "prefix": "pp_AbCd"
  },
  "user": null,
  "scopes": [
    "read",
    "write"
  ],
  "granted_scopes": [
    "read",
    "write"
  ],
  "webhook_events": [
    "post.created",
    "post.approved"
  ]
}
GET/webhooksread

Webhook-Abos dieses Tokens

curl "https://app.sayweek.com/api/v1/webhooks" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/webhookswrite

URL für Ereignisse abonnieren (das Secret kommt nur einmal zurück)

Nur https, nur öffentliche Hosts (keine privaten / lokalen Adressen), Ports 443, 8443, 80, 8080. Zustellungen werden mit wachsenden Pausen etwa anderthalb Tage wiederholt; ein Endpunkt, der einen Tag lang scheitert, wird ausgeschaltet.

Parameter
Idempotency-KeyheaderSpielt 24 Stunden lang die erste Antwort erneut aus (gleicher Schlüssel + gleiche Anfrage)
curl -X POST "https://app.sayweek.com/api/v1/webhooks" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hooks/sayweek","events":["post.approved","post.published"],"description":"CRM sync"}'
Request-Body
{
  "url": "https://example.com/hooks/sayweek",
  "events": [
    "post.approved",
    "post.published"
  ],
  "description": "CRM sync"
}
Beispielantwort
{
  "id": "d4c3b2a1-0000-4000-8000-000000000002",
  "url": "https://example.com/hooks/sayweek",
  "description": "CRM sync",
  "events": [
    "post.approved",
    "post.published"
  ],
  "enabled": true,
  "disabled_reason": null,
  "last_status": null,
  "last_delivery_at": null,
  "created_at": "2026-10-05T09:00:00.000Z",
  "secret": "whsec_…"
}
GET/webhooks/{id}read

Ein Webhook-Abo

Parameter
idpathPflichtID (UUID)
curl "https://app.sayweek.com/api/v1/webhooks/d4c3b2a1-0000-4000-8000-000000000002" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
PATCH/webhooks/{id}write

Webhook-Abo ändern

Nur die gesendeten Felder ändern sich. Eine neue URL wird wie beim Anlegen geprüft; `enabled: true` schaltet einen pausierten oder wegen Fehlern abgeschalteten Endpunkt wieder ein und setzt die Fehlerserie zurück. Das Secret bleibt gleich.

Parameter
idpathPflichtID (UUID)
curl -X PATCH "https://app.sayweek.com/api/v1/webhooks/d4c3b2a1-0000-4000-8000-000000000002" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"events":["post.approved","post.published","post.failed"],"enabled":true}'
Request-Body
{
  "events": [
    "post.approved",
    "post.published",
    "post.failed"
  ],
  "enabled": true
}
Beispielantwort
{
  "id": "d4c3b2a1-0000-4000-8000-000000000002",
  "url": "https://example.com/hooks/sayweek",
  "description": "CRM sync",
  "events": [
    "post.approved",
    "post.published",
    "post.failed"
  ],
  "enabled": true,
  "disabled_reason": null,
  "last_status": 200,
  "last_delivery_at": "2026-10-05T09:12:00.000Z",
  "created_at": "2026-10-05T09:00:00.000Z"
}
DELETE/webhooks/{id}write

Abo beenden

Parameter
idpathPflichtID (UUID)
curl -X DELETE "https://app.sayweek.com/api/v1/webhooks/d4c3b2a1-0000-4000-8000-000000000002" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/webhooks/{id}/testwrite

Jetzt ein signiertes Test-Ereignis senden

Parameter
idpathPflichtID (UUID)
curl -X POST "https://app.sayweek.com/api/v1/webhooks/d4c3b2a1-0000-4000-8000-000000000002/test" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
Beispielantwort
{
  "delivered": true,
  "status": 200,
  "duration_ms": 182,
  "response": "ok"
}

Tag & To-dos

GET/agendaread

Posts und Foto-Vorschläge pro Tag, in deiner Zeitzone

Die Tage werden in `tz` geschnitten (die IANA-Zeitzone des Geräts; Standard: die Heimatzone des Workspace): ein Post landet an dem Tag, auf den sein Zeitpunkt dort fällt; `source` behält seine eigene Ortszeit und Zone. Cross-Posts werden unter dem Haupt-Post zusammengefasst (`sibling_channels`). Foto-Vorschläge sind ganztägige Einträge. Höchstens 31 Tage.

Parameter
fromqueryJJJJ-MM-TT in tz, Standard heute
toqueryJJJJ-MM-TT in tz, Standard from + 6 Tage
tzqueryIANA-Zeitzone, z. B. Europe/Budapest
brand_idqueryNur diese Marke
curl "https://app.sayweek.com/api/v1/agenda" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
GET/todosread

Was die Person hinter dem Token in Sayweek zu tun hat

Bei jedem Aufruf neu berechnet (nie gespeichert): Freigaben, fehlende Videos, das wöchentliche Interview, ablaufende Verbindungen, fehlgeschlagene Posts, Überschneidungen und leere Plätze. Ein To-do verschwindet, wenn die Arbeit in Sayweek erledigt ist – über die API lässt es sich nicht abhaken, nur zurückstellen. `key` ist stabil; `fingerprint` ändert sich mit Text oder Fälligkeit; der `fingerprint` oben gilt für die ganze Liste (vergleiche ihn mit dem Webhook `todos.changed`). Braucht ein Token, das zu einer Person gehört (OAuth oder ein von jemandem erstellter API-Schlüssel).

Parameter
tzqueryIANA-Zeitzone für due_date, Standard die des Workspace
snoozedqueryinclude (Standard) oder exclude
curl "https://app.sayweek.com/api/v1/todos" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"
POST/todos/{key}/snoozewrite

To-do zurückstellen (gibt nichts frei, hakt nichts ab)

Parameter
keypathPflichtDer Schlüssel des To-dos, z. B. approve:2026-W47 (der Doppelpunkt darf prozentkodiert sein)
Idempotency-KeyheaderSpielt 24 Stunden lang die erste Antwort erneut aus (gleicher Schlüssel + gleiche Anfrage)
curl -X POST "https://app.sayweek.com/api/v1/todos/{key}/snooze" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
Request-Body
{}
DELETE/todos/{key}/snoozewrite

Zurückstellen aufheben

Parameter
keypathPflicht
curl -X DELETE "https://app.sayweek.com/api/v1/todos/{key}/snooze" \
  -H "Authorization: Bearer $SAYWEEK_TOKEN"

Ausprobieren

Ruf die API direkt hier mit deinem eigenen Konto auf – ohne Schlüssel zu kopieren. Die Konsole bekommt einen 1-Stunden-Token für den Workspace, in dem du angemeldet bist; die Berechtigung approve bekommt sie nie.

Webhooks

Sayweek schickt ein signiertes JSON-Ereignis per POST an deinen HTTPS-Endpunkt, wenn etwas passiert. Endpunkte fügst du unter Einstellungen → Integrationen → Webhooks hinzu, oder per Code mit POST /webhooks.

Ereignisse

post.createdPost erstelltEin neuer Entwurf oder eine Idee in einem Slot
approval.requestedFreigabe angefragtEin Entwurf ist bereit zur Freigabe
post.approvedPost freigegebenJemand hat einen Post freigegeben
post.scheduledPost eingeplantDer Post ist im Netzwerk eingeplant
post.publishedPost veröffentlichtDer Post ist raus
post.failedVeröffentlichung fehlgeschlagenDer Post ging nicht raus
idea.createdNeue IdeeEine Idee ist im Ideenkasten gelandet
comment.receivedNeuer KommentarJemand hat einen veröffentlichten Post kommentiert
review.commentKunden-FeedbackEine Notiz über einen Freigabelink
todos.changedTo-dos geändertDie Sayweek-To-dos einer Person haben sich geändert (nur API-/OAuth-Abos, über die eigene Person)

Inhalt

HTTP
POST /your/endpoint HTTP/1.1
Content-Type: application/json
User-Agent: Sayweek-Webhooks/1.0
X-Sayweek-Event: post.approved
X-Sayweek-Delivery: <delivery id>
Sayweek-Event-Id: evt_3m9QeX2a7bKfT1
Sayweek-Timestamp: 1791797462
Sayweek-Signature: t=1791797462,v1=5f2b…c09e

{
  "id": "evt_3m9QeX2a7bKfT1",
  "event": "post.approved",
  "api_version": "2026-10-05",
  "created_at": "2026-10-12T07:31:02.000Z",
  "at": "2026-10-12T07:31:02.000Z",
  "workspace_id": "8a1f0c4e-…",
  "data": {
    "postId": "6f1c2b0e-3a4d-4c5e-9f60-1a2b3c4d5e6f",
    "date": "2026-10-12",
    "time": "09:30",
    "text": "Three things a year of weekly posting taught us…"
  }
}

Die Signatur prüfen

Jede Zustellung hat einen Sayweek-Signature-Header: t=<Unix-Sekunden>,v1=<hex HMAC-SHA256 von „t.roher Body“ mit deinem Secret>. Vergleiche in konstanter Zeit und verwirf Zeitstempel, die älter als 5 Minuten sind – das verhindert Replays.

import { createHmac, timingSafeEqual } from "node:crypto";

// Use the RAW request body (before JSON.parse).
export function verifySayweek(secret, rawBody, header, toleranceSec = 300) {
  const parts = Object.fromEntries(header.split(",").map((p) => p.trim().split("=")));
  const t = Number(parts.t);
  if (!t || Math.abs(Date.now() / 1000 - t) > toleranceSec) return false; // replay protection
  const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest("hex");
  const got = Buffer.from(parts.v1 ?? "");
  return got.length === expected.length && timingSafeEqual(got, Buffer.from(expected));
}

Wiederholungen, Protokoll und automatisches Ausschalten

  • Jede 2xx-Antwort innerhalb von 8 Sekunden gilt als zugestellt. Timeouts, Netzwerkfehler, 408, 409, 425, 429 und 5xx werden mit wachsenden Pausen wiederholt (bis zu 8 Versuche über etwa 30 Stunden); andere 4xx-Antworten sind endgültig. Die Ereignis-ID bleibt gleich, so kannst du Duplikate erkennen.
  • Jeder Versuch steht im Zustellprotokoll (Einstellungen → Webhooks → Zustellprotokoll) mit Status, Zeit und den ersten Zeilen deiner Antwort – und lässt sich mit einem Klick erneut senden.
  • Ein Endpunkt, der einen Tag lang nur Fehler liefert, wird automatisch ausgeschaltet, und die Workspace-Inhaber bekommen eine Benachrichtigung. Repariere ihn und schalte ihn wieder ein.
  • Nur öffentliche https://-Adressen sind erlaubt – private, Loopback- und Link-Local-IPs werden blockiert, geprüft beim Speichern und bei jeder Zustellung erneut. Weiterleitungen werden nicht verfolgt.

Claude & ChatGPT

Sayweek ist ein Remote-MCP-Server (Streamable HTTP, OAuth 2.1) – füge ihn mit dieser URL zu Claude oder ChatGPT hinzu:

MCP
https://app.sayweek.com/api/mcp
  • claude.ai: Einstellungen → Connectors → „Add custom connector“ → URL einfügen → Connect → anmelden → Erlauben.
  • ChatGPT: Einstellungen → Apps & Connectors → Advanced → Developer mode → Create → die URL, Authentication: OAuth.

Claude Code:

shell
claude mcp add --transport http sayweek https://app.sayweek.com/api/mcp

Limits

Limits gelten pro Token und Minute. Darüber bekommst du 429 mit einem Retry-After-Header (Sekunden).

120 / Minute

Lesen (GET)

30 / Minute

Schreiben (POST, PATCH, DELETE)

6 / Minute

Generierungen (POST /generate)

Sichere Wiederholungen: Bei POST spielt ein Idempotency-Key-Header 24 Stunden lang die erste Antwort erneut aus. Listen sind seitenweise: { data, next_cursor } – die nächste Seite mit ?cursor=.

Fehler

Fehler sehen immer gleich aus; code ist stabil, message ist für Menschen.

JSON
{
  "error": {
    "code": "insufficient_scope",
    "message": "This API key does not have the \"write\" scope.",
    "details": {
      "required": "write",
      "granted": [
        "read"
      ]
    }
  }
}
401unauthorizedToken fehlt, ist unbekannt, abgelaufen oder widerrufen.
403insufficient_scopeDem Token fehlt die Berechtigung (details.required).
403plan_requiredDer Tarif des Workspace enthält das nicht.
403approvals_disabledFreigaben über die API sind im Workspace ausgeschaltet.
404not_foundSo ein Objekt gibt es in diesem Workspace nicht.
400invalid_requestEin Parameter oder der Body ist ungültig (details sagt, welcher).
409conflictDas Objekt hat sich geändert oder ist in einem Zustand, der das nicht erlaubt.
422idempotency_mismatchDer Idempotency-Key wurde für eine andere Anfrage verwendet.
429rate_limitedZu viele Anfragen – warte Retry-After Sekunden.
500internalUnser Fehler. Versuch es später erneut; wir wissen Bescheid.

SDKs & Tools

Fertige Bausteine – alle aus derselben OpenAPI-Beschreibung erzeugt.

Änderungen

  1. Webhooks mit signierten, wiederholten Zustellungen und Zustellprotokoll; Endpunkte /webhooks und /me; OAuth-Apps mit eigener Zustimmungsseite; die Test-Konsole; Postman-Collection, n8n-Node, JS- und Python-Client.

  2. API v1: Marken, Kanäle, Posts, Ideen, Woche, Generierung, Kalender, Statistik; MCP-Server für Claude und ChatGPT; OAuth 2.1 mit PKCE.

Entwickler: API und MCP (Claude, ChatGPT) – Sayweek