ReelspanUpload guidesDiscord

Post to Discord automatically

Connect Discord once, then send videos, photos, text posts and PDFs to it from code, a workflow or an AI agent. The same call can post to every other network at the same time.
1 min setup2,000 characters16:99:161:17 sections

01

Connect Discord

  1. In Discord, open the channel’s settings → Integrations → Webhooks → New Webhook.
  2. Name it, then Copy Webhook URL.
  3. Paste it in the dashboard. No bot to install.

Posting for clients? Send them a connect link so they connect their own Discord account without a Reelspan login.

02

Get an API key

In the dashboard, open Developers → API keys and create one. Keep it in an environment variable such as REELSPAN_KEY; never in code you share.

03

Post with one request

Send the video as a file, or as a public URL like below. Add more platform[] fields to post the same thing everywhere at once.

curl
curl -X POST https://api.reelspan.com/v1/posts/video \
  -H "Authorization: Bearer $REELSPAN_KEY" \
  -F user=my-brand \
  -F "platform[]=discord" \
  -F "video=https://example.com/clip.mp4" \
  -F "title=Your message" \
  -F "discord_thread_name=…"
JavaScript (Node 18+)
const form = new FormData();
form.append('user', 'my-brand');
form.append('platform[]', 'discord');
form.append('video', 'https://example.com/clip.mp4');
form.append('title', 'Your message');

const res = await fetch('https://api.reelspan.com/v1/posts/video', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.REELSPAN_KEY}` },
  body: form,
});
console.log(await res.json());
Python
import os, requests

res = requests.post(
    "https://api.reelspan.com/v1/posts/video",
    headers={"Authorization": f"Bearer {os.environ['REELSPAN_KEY']}"},
    files=[
        ("user", (None, "my-brand")),
        ("platform[]", (None, "discord")),
        ("video", (None, "https://example.com/clip.mp4")),
        ("title", (None, "Your message")),
    ],
)
print(res.json())

discord_title sets the text for Discord only, when it should differ from the other networks’.

04

Discord options

discord_thread_name
In a forum channel, start a post with this title.
discord_thread_id
Post into an existing thread.
discord_flags
suppress_embeds, suppress_notifications.
discord_max_file_mb
A boosted server’s file limit (10 to 100 MB).
  • Messages go to a channel through its webhook; no bot to install.
  • Files up to 10 MB each, up to 10 per message.

Every field, with its limits: the docs.

05

Schedule it and check the result

  • Add scheduled_date (ISO 8601) and timezone to post later, or add_to_queue=true to take the next slot of your posting schedule.
  • The response has Discord’s status and the post’s link. For big files send async_upload=true and check GET /v1/posts/status?request_id=…, or get a signed webhook when it’s live.
  • If Discord refuses a post, the error says why in plain words, and you can retry just that network.

06

Without code

07

Ideas

  • Announce every YouTube upload in your community server.
  • Post build artifacts and demo videos from CI.

More on Discord: what you can post there. Other networks: all upload guides.

Questions?Talk to a person.Contact us