Tumblr

These are your credentials with the platform, not Postiz credentials.

The keys on this page belong to a developer app you register with the platform. Nobody from Postiz will ever ask for them.

Keep them in your environment or a secret manager, never in a committed .env file, and rotate them at the platform if they leak.

Tumblr connects over OAuth 2.0. After authorising, Postiz asks which of your blogs to post to, so one Tumblr account can become several channels.

Register an application

Go to tumblr.com/oauth/apps and click Register application.

Fill in the application name, description and your website. Tumblr requires all of them.

Set the callback URL

The OAuth2 Redirect URI is the location where the provider will redirect to after a successful login. This needs to be set to your Postiz FRONTEND_URL + /integrations/social/ + {provider}.

You only need to set one OAuth2 Redirect URI when you are setting up your Postiz app.

Your Tumblr redirect URI:

Production: https://your-postiz-domain.com/integrations/social/tumblr
Local development: http://localhost:4200/integrations/social/tumblr
Docker: http://localhost:4007/integrations/social/tumblr

Copy the keys

Tumblr shows an OAuth Consumer Key and, behind Show secret key, an OAuth Consumer Secret. Add both to your environment:

TUMBLR_CLIENT_ID=""
TUMBLR_CLIENT_SECRET=""

Restart and connect

Restart Postiz after changing environment variables. With Docker Compose, run docker compose down then docker compose up -d. A plain restart won't pick up a changed .env.

Variables prefixed NEXT_PUBLIC_ are baked into the frontend at build time, so changing one needs a rebuild of the image, not just a restart.

In Postiz, click Add Channel, pick Tumblr, authorise, then choose the blog you want this channel to post to.

Scopes

Postiz requests write and offline_access. The second one is what lets Postiz refresh its access token, so without it the channel stops working after the first token expires.

Post settings

Tumblr posts accept a title, a link URL, a source URL and tags. Media limits are up to 30 images or a single video. See Posting rules by platform.