Skip to content
About

The Twitter Setup That Took Longer Than Expected

Documented the exact X/Twitter developer setup for Postiz — including the OAuth gotchas, callback URL tricks, and a shared rate limit warning.

1 min readEvergreen
On this page

Sometimes the docs aren't the boring part — they're the whole story.

What happened

I added documentation for how to set up the X (Twitter) provider in Postiz, the social media scheduling tool I'm self-hosting.

The docs cover the exact settings to use in X's developer portal (it has to be a "Native App" type, not a web app — this matters), the specific OAuth credentials needed, and a workaround for cases where the direct callback URL doesn't work. There's a small service called redirectmeto.com that helps bridge the gap.

I also documented a rate limit thing: if you're on the free tier, multiple users sharing the same X credentials hit the same rate limit. Worth knowing before you try to schedule five posts at once and wonder why they're not going out.

Why

Setting up X's developer credentials is genuinely confusing. There are multiple ways to do it and several that look right but don't work. Writing it down means I won't have to figure it out again.


PR: https://github.com/StevieIsmagic/social-media-automation/pull/3

Enjoyed this? Join the newsletter.

New essays and notes straight to your inbox.

Newsletter coming soon — stay tuned.