v3

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-012582298.4 KB
Webhooks

Draft Status Changed

Triggered on any status transition. This event fires alongside specific events like draft.scheduled or draft.published.

postWebhookdraft.status_changed

Payload

event'draft.status_changed' required

The event type that triggered this webhook

Example payload

{
  "data": {
    "id": 12345,
    "social_set_id": 67890,
    "draft_id": 12345,
    "status": "draft",
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-16T09:15:00Z",
    "scheduled_date": "2025-01-20T14:00:00Z",
    "published_at": "2025-01-20T14:00:05Z",
    "draft_title": "Weekly Newsletter",
    "tags": [
      "marketing",
      "product"
    ],
    "preview": "Excited to announce our new feature! 🚀",
    "share_url": "https://typefully.com/share/abc123",
    "private_url": "https://typefully.com/?d=12345&a=67890",
    "platforms": {
      "x": {
        "posts": [
          {
            "subscribers_only": true,
            "paid_partnership": true,
            "made_with_ai": true
          }
        ],
        "settings": {
          "reply_to_url": "https://x.com/therajatkapoor/status/1399394576951959554"
        }
      }
    },
    "x_published_url": "https://x.com/username/status/1234567890",
    "linkedin_published_url": "https://www.linkedin.com/feed/update/urn:li:share:1234567890",
    "mastodon_published_url": "https://mastodon.social/@username/1234567890",
    "threads_published_url": "https://www.threads.net/@username/post/ABC123",
    "bluesky_published_url": "https://bsky.app/profile/username.bsky.social/post/abc123",
    "substack_published_url": "https://substack.com/@username/note/c-123456789",
    "x_article_published_url": "https://x.com/i/article/1234567890",
    "x_post_published_at": "2025-01-20T14:00:05Z",
    "linkedin_post_published_at": "2025-01-20T14:00:08Z",
    "mastodon_post_published_at": "2025-01-20T14:00:10Z",
    "threads_post_published_at": "2025-01-20T14:00:12Z",
    "bluesky_post_published_at": "2025-01-20T14:00:15Z",
    "substack_post_published_at": "2025-01-20T14:00:15Z",
    "x_article_published_at": "2025-01-20T14:00:15Z",
    "scratchpad_text": "line 1\nline 2\n\nline 4"
  }
}

Response

Return any 2xx status to acknowledge receipt