Skip to main content
A Discord connection is one channel in one server, not a whole server. Connect the channel you want Ocoya to post in; connect again for a second channel.

​
Before you start

You need permission to add a webhook in the server — that’s Manage Webhooks, which server admins have by default. If you don’t have it, ask an admin to connect the channel or grant the permission.

​
Connect Discord

1

Open Channels

Select Channels in the left sidebar, then Connect channel.
2

Choose Discord

Pick Discord from the Add a connection panel. It’s below Mastodon in the list.
3

Pick the server and channel

Discord asks which server to add Ocoya to, then which channel to post in. Both choices happen on Discord’s own screen.
4

Authorize

Approve the request. The channel appears on your Channels page.

​
How posts appear

Ocoya publishes through a channel webhook, so posts arrive from an Ocoya webhook rather than from your personal Discord account. That’s how Discord works for any scheduling tool — there’s no way to post as yourself through the API. Disconnecting the channel in Ocoya removes the webhook from Discord.

​
What you can post

Ten attachments in total per post, counting images, videos and GIFs together.

​
Discord’s limits

​
Long posts are refused, not split

This is where Discord differs from X, Threads, Bluesky and Mastodon. Those four split a long caption into a thread. Discord doesn’t — 2,000 characters is a hard ceiling, and a longer caption is refused before publishing. If you’re writing one post for several networks, keep the Discord version under 2,000 characters, or write a separate shorter caption for it.

​
Common problems

“I don’t see the server I want.” You’re signed in to Discord as an account that isn’t in that server, or you lack Manage Webhooks there. “Posts stopped appearing.” Someone deleted the webhook in Discord’s channel settings, or the channel itself was deleted. Reconnect the channel — see Reconnect a channel. “Can it post to a thread or forum channel?” Connect a standard text channel. Threads and forum posts inside Discord aren’t selectable as targets.

Character and media limits

Every network’s limits in one table.

Why didn't my post publish?

Diagnosing a post a network refused.