​
Posting to Threads

JSON for a basic post with a link and image using the Threads API:
Threads Post
{
  "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["threads"]
}
The Threads API has the following requirements and restrictions:
  • Threads will automatically preview the link in the post unless there is an image or video included. In the above example the image will show. Removing the image will cause the link preview to show.
  • Threads profiles are limited to 250 API-published posts within a 24-hour moving period.
  • Threads only allows 1 hashtag per post.
  • @mention Threads users will receive a notification.
  • Maximum 500 post characters.
  • Multi-image/videos posts are supported and sent as a carousel. You may send up to 20 videos and images.
  • Threads does not support deletes via an API. Deletes must occur manually using the Threads app.
  • If your video doesn’t end in a known video extension such as mp4, please use the isVideo parameter. See the /post endpoint for details.
  • Threads also supports sending media without post text. If you do not want post text included send an empty String post: "".
  • See Threads Media Guidelines and Threads Authorization for more information.

​
Threads Options

You can set additional options for a post by using the threadsOptions parameter.
Threads Options
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}
Threads options are optional fields that can be used to control the post.
​
allowCountries
array of strings
Restrict posts to specific countries using country codes. Use country codes.Only available if Meta has enabled geo restrictions for your account.See Threads Geo Restrictions for more information.

​
Adding line breaks or rich text to an Threads post

Threads line breaks can be added to a post with a special new line character. Rich text, such as bold or italic lettering, can be added to a Threads post with a few html elements. You can post multiple images or videos to Threads as a carousel; up to a combined total of 20 images or videos may be use in a carousel. Just add your additional images or videos to the mediaUrls array and the carousel will automatically be created. 
"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos
Video URLs must end in a known extension such as mp4.

​
Character Limits

Please see Threads Character Limits for more information.

​
Geo Restrictions

You can restrict a post to a specific country or countries by using the allowCountries array. 
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}
  • allowCountries: An array of country codes to allow. See country codes.
Geo restrictions (geo-gating) on Threads are only available if Meta has enabled this feature for your account.Meta decides which Threads accounts are eligible for geo restrictions based on factors such as account verification, follower count, or content creator status. If your account is eligible, you will see the geographic settings (globe icon) in the post composer when creating a new Threads post.You can check if a user profile is eligible for Threads geo restrictions by checking the isEligibleForGeoRestrictions property in the /user endpoint.

​
Threads Mentions

Mention another Threads handle by adding @handle in the post text. For example: 
{
  "post": "The best social media API @Ayrshare ever!",
  "mediaUrls": ["https://images.com"],
  "platforms": ["threads"]
}
The @mentioned user will be notified of the mention. Please review the important rules on mentions.
If the quota has been reached, an error message will be returned.