Threads

Publish text or a single image to a Threads profile (Meta Threads API).

Connect

OAuth (per-account, like Instagram):

curl -X POST https://api.herald.leiritech.com/v1/accounts/connect \
  -H "Authorization: Bearer hld_…" -H "Content-Type: application/json" \
  -d '{"network":"threads","redirect_url":"https://your-app.example/connected"}'

Prerequisites (owner): in your Meta app, add the Threads use case (its own App ID/Secret, distinct from Instagram/Facebook); save them in admin → Platform apps under threads; register redirect https://herald.leiritech.com/api/oauth/threads/callback. threads_content_publish needs Meta App Review for public use (own account works in dev/tester mode).

Publish

# text
curl -X POST https://api.herald.leiritech.com/v1/posts \
  -H "Authorization: Bearer hld_…" -H "Content-Type: application/json" \
  -d '{"targets":["<threads-uuid>"],"text":"hello threads","mode":"now"}'

# with an image (upload via /v1/media first)
#   "media_ids":["b1c2…"]

{ "id":"…","status":"published","targets":[{"network":"threads","status":"published",
  "permalink":"https://www.threads.net/@you/post/…","platform_post_id":"…"}] }

Rules & gotchas

• text is required for text posts; one image optional (Herald uses the container → publish flow and waits for the image to process).
• title is ignored.
• No API delete → unpublish returns unsupported for Threads.