Channel Setup Guide
Connect publishing channels, choose the right auth flow, and understand the current platform caveats.
1MarketingTool connects channels from the Channels view. Open the app, go to Distribution -> Channels, expand a channel, paste the required values, save, then use Test or Send test post before scheduling production content.
Secrets are stored through the operating system keychain. OAuth tokens, API keys, webhook URLs, app passwords, and client secrets stay on your machine unless the channel explicitly uses the 1MarketingTool relay.
Auth Models
| Model | What you do | Channels |
|---|---|---|
| Webhook or static token | Create a token, webhook, or app password in the provider UI and paste it into 1MarketingTool. | Telegram, Discord, Slack, Mastodon, Bluesky, X, Dev.to, Hashnode, Medium, WordPress, Ghost, Custom API |
| BYO OAuth app | Create your own developer app, paste its client values, then click Connect with .... | LinkedIn, Pinterest, YouTube, Facebook Page, Instagram, Threads, TikTok |
Redirect URIs
Use the exact redirect URI below when a provider asks for one.
| Channel | Redirect URI |
|---|---|
http://127.0.0.1:53682/callback | |
| Facebook Page | https://oauth.1marketingtool.com/cb |
https://oauth.1marketingtool.com/cb | |
| Threads | https://oauth.1marketingtool.com/cb |
https://oauth.1marketingtool.com/cb | |
| TikTok | https://oauth.1marketingtool.com/cb |
| YouTube | No redirect URI entry. Create a Desktop app OAuth client in Google Cloud. |
Screenshot Walkthroughs
These guides include the copied setup screenshots:
Quick Channels
| Channel | Required values | Notes |
|---|---|---|
| Telegram | Bot token, chat ID | Bot must be an admin with permission to post. Images and videos can be attached. |
| Discord | Webhook URL | Posts through a channel webhook. Images and videos can be attached. |
| Slack | Incoming webhook URL | Text-only. Slack webhook testing is config-only because any real POST creates a message. |
| Mastodon | Instance URL, access token | Supports images or video. Alt text is sent when provided. |
| Bluesky | Handle, app password, optional service URL | Use an app password, not your main account password. Supports images or MP4 video. |
| X / Twitter | API key, API key secret, access token, access token secret | Requires OAuth 1.0a keys with Read and Write permission. X API posting is pay-per-use. |
| Dev.to | API key | Publishes a live article. The first line becomes the title. |
| Hashnode | Personal Access Token, Publication ID | Hashnode API access now requires a Pro publication. |
| Medium | Integration token, optional publication ID | Best-effort path through Medium's self-issued integration token API. |
| Custom API | Endpoint URL, method, headers template, body template, optional secret | Renders each post into your HTTP request template. |
Media Rules
- Pinterest requires an image or video. Video Pins also need a cover image.
- YouTube requires a video file. Shorts are detected by YouTube when the video is vertical or square and 3 minutes or less.
- TikTok requires a video file and sends it to your TikTok inbox or drafts; finish posting in the TikTok app.
- Instagram requires media and an Instagram Professional account (Instagram login — no linked Facebook Page needed).
- Slack, WordPress, Ghost, Dev.to, Hashnode, Medium, Threads, and Custom API do not upload attached media in the current publisher path.
Current Caveats
Reddit and LinkedIn Page publishing are reserved but not available in the current build. Facebook Page and Instagram use your own Meta app; Development mode works for Pages and Instagram accounts you administer. Pinterest production posting requires Standard access approval. Unverified Google apps can require reconnecting YouTube after roughly 7 days and may keep uploads private until verification is complete.