Overview
Create Post
Publish a new Post
Delete Post
Delete an existing Post
Reply
Reply to another Post
Quote
Quote another Post
Endpoints
Creating Posts
Basic Post
Self-serve customers: Posts created via the API are limited to a maximum of 1 cashtag per post.
Reply to a Post
Self-serve customers: Replies are only permitted if the original post’s author has explicitly summoned the replying account by @mentioning them or quoting one of their posts.
Quote a Post
Post with media
Upload media first using the chunked media upload endpoints (
/2/media/upload/initialize, /{id}/append, /{id}/finalize), then reference the media_id in your Post.media_category used at upload:
If the video is longer than that user is allowed to post, the response is 403 Forbidden:
This user is not allowed to post a video longer than N minutes. A successful upload does not guarantee the media can be attached. See size and duration limits.
Post with poll
Post with paid partnership
Use thepaid_partnership field when creating a Post to indicate it is a paid partnership (i.e., the author is disclosing that the Post contains paid promotion). When set to true, the Post will be labeled as a paid promotion.
tweet.fields parameter:
Deleting Posts
Getting started
Prerequisites
- An approved developer account
- A Project and App in the Developer Console
- User Access Tokens via OAuth 2.0 PKCE or 3-legged OAuth
Quickstart
Create your first Post
Integration guide
Key concepts and best practices
Media upload
Upload media for Posts
API Reference
Full endpoint documentation