---
title: "Twitch API: post and schedule from code"
url: "https://get1post.com/developers/twitch.md"
canonical_url: "https://get1post.com/developers/twitch"
last_updated: "2026-10-26"
type: "reference"
summary: "Post and schedule to Twitch with the 1Post API and MCP server: the request, the reply, every rule it is checked against and a dry run."
related: ["https://get1post.com/platforms/twitch.md", "https://get1post.com/platforms/twitch/specs.md", "https://get1post.com/docs/api-posts.md", "https://get1post.com/docs/mcp.md"]
---

# Twitch API: post and schedule from code

Post and schedule to Twitch with the 1Post API and MCP server: the request, the reply, every rule it is checked against and a dry run.

Post to Twitch from code with one request: POST /v1/posts with your channel id, the text and a schedule_at time. Twitch text is limited to 500 characters, counted by code points. 1Post allows up to 20 posts a day for each connected channel, and a dry run checks a post against every rule first.

## Connect Twitch first

1. Open Accounts in 1Post and choose Connect.
2. Pick Twitch.
3. Sign in with Twitch and approve access for the channel you want to post to.
4. Choose the channel in 1Post. It is ready to pick in the composer.

Then GET /v1/accounts returns the id of the Twitch channel to use in the request.

## Send a post to Twitch

**Schedule a post**

```bash
curl https://api.get1post.com/v1/posts \
  -H "Authorization: Bearer $ONEPOST_API_KEY" \
  -H "Idempotency-Key: twitch-first-post" \
  -d '{"accounts":["ACCOUNT_ID"],"text":"Stream starts at 8 PM tonight: new map, new rules.","schedule_at":"2026-11-02T15:00:00Z"}'
```

The reply is 202 with the post (status scheduled) and one destination for Twitch, which moves from queued to published or failed.

## What you can send to Twitch

- Chat message
- Announcement

## Twitch rules the request is checked against

| Rule | What 1Post checks |
| --- | --- |
| Text limit | 500 characters, counted by code points |
| Media accepted | Text only |
| Threads | No |
| First comment | No |
| Posts per day, per connected account (1Post) | 20 |

The same table with sources is on the [Twitch specs page](https://get1post.com/platforms/twitch/specs.md).

## Good to know for Twitch

A Twitch post is a chat line in your own channel, sent as the channel itself. Set announcement to true in the account's settings to send an announcement instead of an ordinary chat message. Twitch can still refuse a line at send time: a ban, a timeout or the channel's chat mode fails it as not_allowed_in_chat, and a line Twitch holds back for review fails as message_failed_review, so change the wording and send it again.

## Check the post before it is queued

Add "dry_run": true to test a post: nothing is kept, a valid one answers 200 and a broken one answers 422 naming the rule.

**A refused request, abridged**

```json
{
  "error": {
    "code": "invalid_for_platform",
    "message": "twitch refuses this post: Twitch counts 532 of 500 characters in part 1. (text_too_long).",
    "fix": "Fix the rule named in the message and send the post again.",
    "retryable": false,
    "request_id": "REQUEST_ID"
  }
}
```

An assistant connected to the [MCP server](https://get1post.com/docs/mcp.md) sends the same fields to create_post; [set one up](https://get1post.com/assistants.md).

## Questions

**Can I post to Twitch with an API key?**

Yes. A key with write scope can create, change and cancel Twitch posts for the workspace it belongs to, with the role of the member who made it. See [API authentication](https://get1post.com/docs/api-authentication.md).

**What happens if a Twitch post breaks a rule?**

The request is refused with invalid_for_platform and the failing rule is named. Fix it and send the request again, or send it with dry_run to test the fix first.

**How many Twitch posts can I send in a day?**

Up to 20 for each connected channel. A request that would pass that answers daily_cap with the time the day frees up.

**Can I send an announcement as well as a chat line?**

Yes. Choose Chat message or Announcement in the composer; both go to the chat of your own channel.

## Related

- [Schedule Twitch posts: formats, limits, setup](https://get1post.com/platforms/twitch.md)
- [Twitch specs and limits: text, media, daily cap](https://get1post.com/platforms/twitch/specs.md)
- [Creating and changing posts with the API: 1Post docs](https://get1post.com/docs/api-posts.md)
- [The MCP server: 1Post docs](https://get1post.com/docs/mcp.md)