---
title: "Upload Post Webhook"
method: POST
path: "/webhooks/upload-post"
---

# Upload Post Webhook

`POST /webhooks/upload-post`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/webhooks/upload-post`
- Auth: none declared

## Request body

- UploadPostWebhookPayload
  - `event` 'upload_completed' | 'social_account_connected' | 'social_account_disconnected' | 'social_account_reauth_required', nullable
  - `job_id` string, nullable
  - `user_email` string, nullable
  - `profile_username` string, nullable
  - `profile` string, nullable
  - `user` string, nullable
  - `username` string, nullable
  - `upload_post_user` string, nullable
  - `user_profile` object, nullable
  - `platform` 'bluesky' | 'facebook' | 'google_business' | 'instagram' | 'linkedin' | 'pinterest' | 'reddit' | 'snapchat' | 'threads' | 'tiktok' | 'tiktok_business' | 'x' | 'youtube', nullable
  - `media_type` 'video' | 'photo' | 'text', nullable
  - `title` string, nullable
  - `caption` string, nullable
  - `result` UploadPostWebhookResult
    - `success` boolean, nullable
    - `url` string, nullable
    - `publish_id` string, nullable
    - `post_id` string, nullable
    - `error` string, nullable
  - `account_name` string, nullable
  - `status` 'connected' | 'disconnected' | 'reauth_required', nullable
  - `reason` string, nullable
  - `created_at` string, date-time, nullable
  - `connected_platforms` object, nullable
  - `platforms` union
    - object
    - string[]
  - `accounts` union
    - object
    - string[]

## Response `200`

Successful Response

- UploadPostWebhookResponse
  - `ok` boolean
  - `updated` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tellers/apis/tellers-api.md) - [All operations](https://skmtc.dev/tellers/apis/tellers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tellers/apis/tellers-api/revisions/fdaa0fa44a26?raw)