Create Posts

{
  "type": "object",
  "properties": {
    "card_uri": {
      "type": "string",
      "description": "Card URI parameter."
    },
    "community_id": {
      "type": "string",
      "description": "Community to post the tweet to."
    },
    "direct_message_deep_link": {
      "type": "string",
      "description": "Direct message deep link."
    },
    "edit_options": {
      "type": "object",
      "description": "Edit an existing tweet rather than creating a new one.",
      "required": [
        "previous_post_id"
      ],
      "properties": {
        "previous_post_id": {
          "type": "string",
          "description": "The ID of the Post being edited."
        }
      },
      "additionalProperties": false
    },
    "for_super_followers_only": {
      "type": "boolean",
      "description": "Restrict tweet to super followers."
    },
    "geo": {
      "type": "object",
      "description": "Geo location for the tweet.",
      "required": [
        "place_id"
      ],
      "properties": {
        "place_id": {
          "type": "string",
          "description": "Place ID for geo tagging."
        }
      },
      "additionalProperties": false
    },
    "made_with_ai": {
      "type": "boolean",
      "description": "Disclose that the tweet contains AI-generated media."
    },
    "media": {
      "type": "object",
      "description": "Media attachments.",
      "required": [
        "media_ids"
      ],
      "properties": {
        "call_to_actions": {
          "type": "object",
          "description": "Call-to-action button rendered on the media entity.",
          "properties": {
            "app_install": {
              "type": "object",
              "description": "App Install CTA. At least one store id should be provided.",
              "properties": {
                "app_store_id": {
                  "type": "string",
                  "description": "Apple App Store iPhone app id."
                },
                "ipad_app_store_id": {
                  "type": "string",
                  "description": "Apple App Store iPad app id."
                },
                "play_store_id": {
                  "type": "string",
                  "description": "Google Play Store app id."
                }
              },
              "additionalProperties": false
            },
            "visit_site": {
              "type": "object",
              "description": "Visit Site CTA.",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "description": "HTTPS URL the CTA links to."
                }
              },
              "additionalProperties": false
            },
            "watch_now": {
              "type": "object",
              "description": "Watch Now CTA.",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "description": "HTTPS URL the CTA links to."
                }
              },
              "additionalProperties": false
            }
          },
          "additionalProperties": false
        },
        "description": {
          "type": "string",
          "description": "Description for the media, rendered on the Post card for video and Amplify content."
        },
        "embeddable": {
          "type": "boolean",
          "description": "When true, the media's asset URLs do not expire and external syndicated playback is allowed."
        },
        "media_ids": {
          "type": "array",
          "description": "Media IDs to attach to the tweet.",
          "items": {
            "type": "string"
          }
        },
        "preview_media_id": {
          "type": "string",
          "description": "Media id whose asset is used as the preview image."
        },
        "tagged_user_ids": {
          "type": "array",
          "description": "User IDs tagged in the media.",
          "items": {
            "type": "string"
          }
        },
        "title": {
          "type": "string",
          "description": "Title for the media, rendered on the Post card for video and Amplify content."
        }
      },
      "additionalProperties": false
    },
    "nullcast": {
      "type": "boolean",
      "description": "If true, the tweet is not shown in the public timeline."
    },
    "paid_partnership": {
      "type": "boolean",
      "description": "Disclose that the tweet is a paid partnership."
    },
    "poll": {
      "type": "object",
      "description": "Poll configuration.",
      "required": [
        "duration_minutes",
        "options"
      ],
      "properties": {
        "duration_minutes": {
          "type": "integer",
          "description": "Duration of the poll in minutes."
        },
        "options": {
          "type": "array",
          "description": "Poll options (2-4 choices, 1-25 characters each).",
          "items": {
            "type": "string"
          }
        },
        "reply_settings": {
          "type": "string",
          "description": "Who can reply to the poll Tweet. Accepted for compatibility; it carries no backend argument and is dropped before the mutation is issued (see `translate_body`).",
          "enum": [
            "following",
            "mentionedUsers",
            "subscribers",
            "verified"
          ]
        }
      },
      "additionalProperties": false
    },
    "quote_tweet_id": {
      "type": "string",
      "description": "Tweet ID to quote."
    },
    "reply": {
      "type": "object",
      "description": "Tweet reply configuration.",
      "required": [
        "in_reply_to_tweet_id"
      ],
      "properties": {
        "auto_populate_reply_metadata": {
          "type": "boolean",
          "description": "If true, reply metadata is automatically populated. Accepted for compatibility; it carries no backend argument and is dropped before the mutation is issued (see `translate_body`)."
        },
        "exclude_reply_user_ids": {
          "type": "array",
          "description": "User IDs to exclude from the reply thread.",
          "items": {
            "type": "string"
          }
        },
        "in_reply_to_tweet_id": {
          "type": "string",
          "description": "The ID of the tweet being replied to."
        }
      },
      "additionalProperties": false
    },
    "reply_settings": {
      "type": "string",
      "description": "Who can reply to this tweet.",
      "enum": [
        "following",
        "mentionedUsers",
        "subscribers",
        "verified"
      ]
    },
    "share_with_followers": {
      "type": "boolean",
      "description": "Share an exclusive (super-follower) tweet with all followers."
    },
    "text": {
      "type": "string",
      "description": "Text of the tweet. Required unless media is provided.  Defaulted to an empty string so it is always sent: the backend's `tweet_text` variable is non-null and rejects an absent value."
    }
  },
  "additionalProperties": false
}