# Threads API Guide (2026): Post, Tokens, Rate Limits and Scheduling | Reeling Blog

> Threads API in 2026: publish in two calls, get a 60-day token, stay under 250 posts per 24 hours and 5 links, fix errors and schedule via REST or MCP.

Canonical: https://reeling.app/blog/threads-api-guide-post-tokens-rate-limits
Last updated: 2026-11-16

## Summary

Yes. Meta's official Threads API publishes text, image and video posts in two calls on graph.threads.com: POST /{threads-user-id}/threads creates a container, then POST /{threads-user-id}/threads_publish posts it. You need threads_basic and threads_content_publish, a 60-day refreshable token, and must stay within 500 characters, 250 posts per 24 hours and 5 links.

- **Author**: Reeling Team
- **Published**: 2026-11-16
- **Last reviewed**: 2026-11-16
- **Category**: Developer & Agents

## Does Threads have an API, and is it free?

Yes. Meta opened the official Threads API to all developers on June 18, 2024, and the docs we read on November 16, 2026 list no usage fee or paid tier, only quotas such as 250 posts per profile per 24 hours. Posting for people who are not your app's testers needs App Review.

Last verified: November 16, 2026, against the Meta pages in Sources.

| What you need | Value | Meta page |
| --- | --- | --- |
| Base URL | https://graph.threads.com/v1.0 (graph.threads.net also works) | Overview |
| Two calls | POST /{threads-user-id}/threads, then POST /{threads-user-id}/threads_publish with creation_id | Posts |
| Permissions | threads_basic plus threads_content_publish | Posts |
| Limits | 500 characters (emoji count as UTF-8 bytes), 5 links, 250 posts per rolling 24 hours | Posts, Overview |

## How do I get a Threads API access token and how long does it last?

Send the user through Threads' authorization window, exchange the one-hour, single-use code for a short-lived token, then swap that for a long-lived token with grant_type=th_exchange_token. A long-lived token lasts 60 days and can be refreshed once it is at least 24 hours old, so run a scheduled refresh job.

Use the Threads app ID and secret, not the main app ID, and keep the secret server side.

| Step | Call on graph.threads.com | Result |
| --- | --- | --- |
| Code to short-lived token | POST /oauth/access_token with grant_type=authorization_code | Valid 1 hour |
| Short-lived to long-lived | GET /access_token with grant_type=th_exchange_token | Valid 60 days |
| Refresh | GET /refresh_access_token with grant_type=th_refresh_token | Token must be 24 hours old; valid 60 days again |

## How do I post to Threads with the API?

Call POST /{threads-user-id}/threads with media_type set to TEXT, IMAGE or VIDEO plus your text or public media URL to create a container, then call POST /{threads-user-id}/threads_publish with that container's id as creation_id. Meta advises waiting about 30 seconds before publishing a media container. Text is limited to 500 characters.

Check clip dimensions and caption length first, then run these four calls in order, copying the container id from the create response into CONTAINER_ID. We ran them only against a local mock.

```
H=https://graph.threads.com/v1.0
curl -s "$H/$USER_ID/threads_publishing_limit?fields=quota_usage,config&access_token=$TOKEN"
curl -s -X POST $H/$USER_ID/threads -d media_type=TEXT --data-urlencode "text=Hello from the Threads API" -d access_token=$TOKEN
# video: media_type=VIDEO and video_url; poll this once a minute until FINISHED
curl -s "$H/$CONTAINER_ID?fields=status,error_message&access_token=$TOKEN"
curl -s -X POST $H/$USER_ID/threads_publish -d creation_id=$CONTAINER_ID -d access_token=$TOKEN
```

- [Free video aspect ratio calculator](https://reeling.app/tools/video-aspect-ratio-calculator)
- [Social post formatter and length checker](https://reeling.app/tools/social-post-formatter)

## What are the Threads API rate limits?

Each Threads profile can publish 250 API-published posts, send 1,000 replies and make 100 deletions in any rolling 24 hours, and a carousel counts as one post. Separately, an app's call count is capped at 4,800 times the number of impressions per 24 hours, with impressions floored at 10.

Read GET /{threads-user-id}/threads_publishing_limit?fields=quota_usage,config before each publish; quota_total is 250.

## Can I schedule Threads posts through the API?

Not natively. The Threads publishing reference lists no scheduling or publish-time parameter, and the changelog through August 18, 2026 has no scheduling entry. Your app keeps the queue, creates the container shortly before the due time, publishes at the due time and enforces the 250-post quota itself.

| When | What your scheduler does | Why |
| --- | --- | --- |
| On scheduling | Store text, media URL and due time; no container yet | Containers expire after 24 hours |
| Due time minus 6 minutes (video) | Check quota, create container, poll status once a minute, at most 5 times | Our schedule, from Meta's wait and polling advice |
| Due time | POST threads_publish once; if it times out, read the container status | PUBLISHED means it already posted |

- [Reeling REST API v1 publishing reference](https://reeling.app/developers/api)

## Threads API errors and how to fix them

These rows come from Meta's troubleshooting, posts and token pages.

| Symptom | Cause | Fix |
| --- | --- | --- |
| THREADS_API__LINK_LIMIT_EXCEEDED | More than 5 unique links (enforced since December 22, 2025) | Cut links; a link_attachment repeating a text URL counts once |
| Calls fail after 60 days | Long-lived token not refreshed within 60 days | Refresh once it is 24 hours old, well before day 60 |
| Container ERROR or EXPIRED | Media processing failed, or no publish within 24 hours | Check the public URL and media specs; create a new container |
| Works for you, not customers | Without advanced access only Threads testers can be posted for | Add testers, or pass App Review and publish the app |

## Build on the Threads API or use a scheduler API?

Build directly on Meta's API when you need text-only, image, carousel, poll or GIF posts, or full control of review and tokens. Use a scheduler API when you mainly queue video posts across networks and want to skip the Meta app, token jobs and queue. Reeling's Threads support is video container publishing.

| Need | Meta's Threads API | Reeling REST API v1 or MCP |
| --- | --- | --- |
| Review and tokens | You build the app, App Review and a refresh job | Authorize once in Connect Channels; development-mode accounts may need tester access |
| Post types | Text, image, video, carousel, polls, GIFs | Video up to 100 MiB (MP4 or MOV), text up to 500 characters |

- [Reeling MCP server setup for developers](https://reeling.app/developers/mcp)
- [Reeling Threads integration: limits and capabilities](https://reeling.app/integrations/threads)

## Frequently Asked Questions

### Does Threads have an API, and is it free?

Yes. Meta's official Threads API has been open to all developers since June 18, 2024. Meta's docs list no usage fee, only limits such as 250 posts per rolling 24 hours.

### How long does a Threads API access token last?

A short-lived token lasts 1 hour and a long-lived token 60 days. Refresh a long-lived token with grant_type=th_refresh_token once it is 24 hours old and before it expires.

### Can I schedule Threads posts through the API?

Not natively: Meta's publishing reference has no scheduling parameter. Keep your own queue and enforce the 250-post quota yourself; a scheduler API such as Reeling's accepts scheduled_for.

## Primary Sources & Documentation

- [Meta: Threads overview and limits (checked 2026-11-16)](https://developers.facebook.com/documentation/threads/overview)
- [Meta: Long-lived tokens (checked 2026-11-16)](https://developers.facebook.com/documentation/threads/get-started/long-lived-tokens)
- [Meta: Threads posts and media (checked 2026-11-16)](https://developers.facebook.com/documentation/threads/posts)
- [Meta: Publishing reference (checked 2026-11-16)](https://developers.facebook.com/documentation/threads/reference/publishing)
- [Meta: Troubleshooting (checked 2026-11-16)](https://developers.facebook.com/documentation/threads/troubleshooting)
- [Meta: Threads changelog (checked 2026-11-16)](https://developers.facebook.com/documentation/threads/changelog)

## Related

- [All Publishing Guides](https://reeling.app/blog)
- [Prepare a video for Threads and Bluesky in Reeling](https://reeling.app/blog/cross-posting-to-threads-and-bluesky)
- [Bluesky MCP Setup: Post to AT Protocol with App Passwords and AI Agents](https://reeling.app/blog/bluesky-mcp-server-setup-app-password)
- [Monitor social publishing failures without duplicate posts](https://reeling.app/blog/monitor-social-publishing-failures)
- [Free Creator Tools](https://reeling.app/tools)
- [Plans & Pricing](https://reeling.app/pricing)

---
Need the interactive version? Visit https://reeling.app/blog/threads-api-guide-post-tokens-rate-limits
Full site index for AI agents: https://reeling.app/llms.txt
