Threads API

Draft X threads.

1 endpoint. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

POST/v1/orgs/{orgId}/marketing/threads

Bearer tokenMCP tool: create_x_thread

Creates an X thread in pending_approval: the first post plus replies that follow it. Never schedules or publishes.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• titlestringrequired
• topicstring
• objectivestring
• postsarray<string>
• textstring
• numberedboolean
• socialAccountIdstring (uuid)
• mediaobject
  Option 1

  • kind"image"required
  • assetIdstring (uuid)required
  • urlstring (uri)required
  • contentTypestringrequired
  • sizeBytesintegerrequired
  • widthinteger
  • heightinteger
  • altTextstring
  Option 2

  • kind"images"required
  • imagesarray<object>required
    Item fields

    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • widthinteger
    • heightinteger
    • altTextstring
  Option 3

  • kind"document"required
  • assetIdstring (uuid)required
  • urlstring (uri)required
  • contentType"application/pdf"required
  • sizeBytesintegerrequired
  • titlestringrequired
  • pageCountinteger
  • previewImageUrlsarray<string (uri)>
  Option 4

  • kind"video"required
  • assetIdstring (uuid)required
  • urlstring (uri)required
  • contentTypestringrequired
  • sizeBytesintegerrequired
  • durationSecondsnumberrequired
  • widthintegerrequired
  • heightintegerrequired
• quoteTweetUrlstring
• communityUrlstring
• replySettingsstring

  one of everyone, following, mentionedUsers, verified

• pollobject
  Fields

  • optionsarray<string>required
  • durationMinutesintegerrequired

Responses

200Creates an X thread in pending_approval: the first post plus replies that follow it. Never schedules or publishes.

• dataobjectrequired
  Fields

  • groupobjectrequired
    Fields

    • idstring (uuid)required
    • orgIdstring (uuid)required
    • titlestringrequired
    • topicstring | nullrequired
    • objectivestring | nullrequired
    • statusstringrequired

      one of draft, pending_approval, approved, scheduled, canceled

    • timezonestringrequired
    • scheduledForstring | nullrequired
    • approvedBystring (uuid) | nullrequired
    • approvedAtstring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
    • scheduleReasonstring | null
    • tagIdsarray<string (uuid)>
    • approvalsarray<object>
      Item fields

      • idstring (uuid)required
      • levelstringrequired

        one of group, post

      • groupIdstring (uuid)required
      • postIdstring (uuid) | nullrequired
      • approvedByUserIdstring (uuid)required
      • approvedAtstringrequired
      • actionstringrequired

        one of submit_for_approval, approved, reapproved, rejected

    • strategyIdstring (uuid) | null
    • strategyVersioninteger | null
    • pillarIdstring | null
    • priorityIdstring | null
    • contentTypestring | null
    • opportunityIdstring | null
  • postsarray<object>required
    Item fields

    • idstring (uuid)required
    • orgIdstring (uuid)required
    • groupIdstring (uuid)required
    • platformstringrequired

      one of x, linkedin, tiktok, reddit, facebook, instagram, youtube, bluesky, threads

    • socialAccountIdstring (uuid) | nullrequired
    • statusstringrequired

      one of draft, pending_approval, approved, scheduled, publishing, awaiting_platform, published, failed, canceled

    • scheduledForUtcstring | nullrequired
    • contentTextstringrequired
    • mediaobject | nullrequired
    • platformPayloadobject | nullrequired
    • publishedExternalIdstring | nullrequired
    • publishedUrlstring | nullrequired
    • attemptCountnumberrequired
    • lastAttemptAtstring | nullrequired
    • nextRetryAtstring | nullrequired
    • lastErrorstring | nullrequired
    • idempotencyKeystring | nullrequired
    • createdAtstringrequired
    • updatedAtstringrequired
    • scheduleReasonstring | null
    • approvalsarray<object>
      Item fields

      • idstring (uuid)required
      • levelstringrequired

        one of group, post

      • groupIdstring (uuid)required
      • postIdstring (uuid) | nullrequired
      • approvedByUserIdstring (uuid)required
      • approvedAtstringrequired
      • actionstringrequired

        one of submit_for_approval, approved, reapproved, rejected

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/threads" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title":"string"}'