Schedule note
schedule_noteSchedule a note to any combination of Substack, LinkedIn, X, Bluesky, Threads, Instagram, Facebook, TikTok, and Pinterest; Instagram, TikTok, and Pinterest require an image or video. Creates a note draft when draftId is absent. Character limits: Bluesky 300, Threads 500, LinkedIn 3000, X 25000 (posted as a thread). Explicit platformVersions must fit their limits; otherwise overlong platform text is shortened at a sentence boundary, with adjustedPlatforms and warnings returned. When a writer has several connected accounts on Threads, Facebook, TikTok, Pinterest or X, the Note goes to the default account unless socialAccountIds names one from list_social_accounts; with several and no default the request is refused until one is named. Authorized team routing uses workspace and writer. Substack Notes publish from the verified connected profile, not a publication page. Safe to retry: pass a new clientRequestId for each note and reuse it when retrying that note, and a repeat returns the original result instead of scheduling again. Even without one, a note with the same text, platform and time as one scheduled in the last 24 hours is not copied: the result has duplicate: true and the existing schedule ids. To quote a Substack Note or post (like "Restack with a note"), pass its link as quoteUrl rather than in content. To schedule several notes, prefer schedule_notes. To send a Note that is already scheduled to another platform or account, use add_platform_to_scheduled_note instead: scheduling it again creates a separate Note.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| media | No | Optional media objects supporting image or video bytes as data URIs or base64, or public HTTPS URLs. In ChatGPT, for a file the user attached in the chat, first call upload_media with it in file, then pass the returned publicUrl here as url. | |
| title | No | Used only when creating a new note draft. | |
| writer | No | Authorized team writer name, handle, or id. "me" selects the linked team voice. Required when a team workspace has multiple writers. | |
| content | No | Used only when creating a new note draft. | |
| draftId | No | Optional existing note draft id to schedule as-is. | |
| quoteUrl | No | Optional public Substack Note link (https://substack.com/@writer/note/c-123) or Substack post/article link (https://publication.substack.com/p/slug, or the publication's custom domain) to quote. Substack shows it as a quoted card under the note, like "Restack with a note". Do not also put the link in content; if it is there it is taken out. Requires SUBSTACK in platforms; every other platform gets the link at the end of its text instead. Cannot be combined with draftId. Nothing is scheduled when the Note or post cannot be found or is not public. Use preview_note_quote to check a link first. | |
| timezone | No | IANA timezone the scheduledFor time above is expressed in (e.g. "Europe/London"). Default UTC. | |
| imageUrls | No | Optional image URLs or image data URIs to attach to the scheduled note. | |
| platforms | Yes | ||
| videoUrls | No | Optional video URLs or video data URIs to attach to the scheduled note. | |
| workspace | No | Authorized team workspace name or id for team scheduling. Absence selects the authenticated user’s personal account. | |
| firstReply | No | Optional first reply for supported destinations. An invalid reply is omitted per platform without cancelling the root post. | |
| publication | No | Substack publication name, handle, or URL selected by the user. Optional when exactly one active Substack publication is connected: Narrareach uses it when its session is ready and says which one was used in substackPublicationSelection.message (source "sole_connection"); if the session needs a sync or the profile cannot be verified, nothing is scheduled and the result says what to fix. In a team workspace with one publication, or when a writer who is also a team member omits workspace, nothing is scheduled until the writer confirms it (requiresPublicationChoice: true, publicationChoiceReason: "confirmation_required"). Notes publish from the profile signed in to that connection, including publications sharing one login. Unverified or mismatched profile identity returns action_required without publishing. Notes are profile-level: when it is missing and all of the writer’s publications are signed in to one Substack profile, no choice is needed and the note posts from that profile. Only when the publications span two or more Substack profiles does the writer choose a profile: Narrareach uses the one they chose most recently (and says so in substackPublicationSelection.message), or, with no previous choice, nothing is scheduled and the result has requiresPublicationChoice: true, choiceScope: "profile" and publicationChoices (one per profile); ask the user, then call again with substackConnectionId set to the chosen publicationChoices[].substackConnectionId. An ambiguous publication value also returns publicationChoices. | |
| generationId | No | Optional. Pass the generationId from create_generated_notes when scheduling a generated note: the requestId that create_generated_notes returned. Used only to measure how generated notes are used; it does not change what is scheduled. | |
| scheduledFor | Yes | Local wall-clock publishing date/time interpreted in timezone, including DST (e.g. "2026-07-01T14:30:00" means 2:30 PM). A Z or explicit UTC offset represents an absolute instant instead. | |
| shortVersion | No | One short text for several platforms, e.g. { "text": "...", "platforms": ["X", "BLUESKY", "THREADS"] }, while the other platforms post content as written. Saved as one shared short version the writer edits once in the app. It must fit the tightest platform it goes to (X 280 as one post, Bluesky 300, Threads 500, LinkedIn 3000) or nothing is scheduled. A platform in it cannot also be in platformVersions. | |
| clientRequestId | No | Optional but recommended: your own id for this note, 8 to 80 letters, numbers, hyphens or underscores. Use a new one for each note and the same one when retrying it (for example after a timeout or a rate-limit pause): the retry returns the original result and schedules nothing again. Reusing it with different text, platforms or time is refused. | |
| threadsTopicTag | No | Optional Threads topic tag. Threads must be selected; maximum 50 characters. | |
| platformVersions | No | Optional platform-specific text keyed by platform, e.g. { "BLUESKY": "..." }. Each supplied version must fit its limit (Bluesky 300, Threads 500, LinkedIn 3000, X 25000) or nothing is scheduled. Saved as the draft’s platform-specific version. | |
| socialAccountIds | No | Optional account to post to on Threads, Facebook, TikTok, Pinterest or X, keyed by platform, e.g. { "THREADS": "<accountId>" }, with accountId values from list_social_accounts. Omit a platform to use its only account or its default. Required for a platform where list_social_accounts reports accountChoiceRequired; ask the writer which account rather than picking one. | |
| linkedInAccountId | No | Optional LinkedIn account id for a connected LinkedIn destination. Absence of both this field and linkedInOrganizationUrn selects the configured default. | |
| substackConnectionId | No | Exact Substack connection identifier, retained for backward compatibility, for example publicationChoices[].substackConnectionId from a requiresPublicationChoice result. publication is the preferred public destination selector; when both are given they must name the same publication. | |
| instagramDestinations | No | Instagram destinations with accountId returned by list_instagram_destinations and optional independent caption. Each account receives its own delivery receipt. | |
| linkedInOrganizationUrn | No | Optional LinkedIn Company Page URN for a connected LinkedIn destination. Requires linkedInAccountId. | |
| confirmProfileDestination | No | Deprecated compatibility field. It is ignored and does not override Substack profile routing safety. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| count | No | ||
| notes | No | ||
| quote | No | ||
| status | No | ||
| context | No | ||
| message | No | ||
| nextStep | No | ||
| replayed | No | ||
| warnings | No | ||
| duplicate | No | ||
| firstReply | No | ||
| choiceScope | No | ||
| sideEffects | No | ||
| createdDraft | No | ||
| actionMessage | No | ||
| supersededIds | No | ||
| preservedDraft | No | ||
| clientRequestId | No | ||
| threadsTopicTag | No | ||
| connectedAccount | No | ||
| adjustedPlatforms | No | ||
| preservedSchedule | No | ||
| confirmationPrompt | No | ||
| connectionWarnings | No | ||
| duplicatePlatforms | No | ||
| publicationChoices | No | ||
| existingScheduleIds | No | ||
| linkedinDestination | No | ||
| proposedDestination | No | ||
| substackPublication | No | ||
| requestedPublication | No | ||
| requiresConfirmation | No | ||
| publicationChoiceReason | No | ||
| substackNoteDestination | No | ||
| requiresPublicationChoice | No | ||
| substackPublicationSelection | No |