Discord

Discord publishing runs through a hosted bot. The server owner installs it with OAuth, you bind a channel, and from then on you post with POST /v1/posts using the platform id discord. You never create a Discord application, request privileged intents or keep a gateway connection open. The same bot sends DMs and manages roles, members, pins and scheduled events over plain REST calls.

#What you will be able to do

#Connect

curl "https://api.pozy.ai/v1/connect/discord?profileId=66a1f0c2a4b9d3e8f1a2b3c4&redirect_url=https://app.example.com/connected" \
  -H "Authorization: Bearer $POZY_API_KEY"

curl -X POST https://api.pozy.ai/v1/connect/discord \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "profileId": "66a1f0c2a4b9d3e8f1a2b3c4", "guildId": "1180000000000000000", "channelId": "1180000000000000123" }'

The bot asks for these permissions at install: Send Messages, Embed Links, Attach Files, Send Messages in Threads, Create Public Threads, Manage Messages (pins), Manage Roles and Manage Events.

#Post types

A post with only content becomes a text message in the channel named by platformSpecificData.channelId, which is required.

curl -X POST https://api.pozy.ai/v1/posts \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Patch 1.8 is live. Full notes below.",
    "platforms": [{
      "platform": "discord",
      "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
      "platformSpecificData": {
        "channelId": "1180000000000000123",
        "embeds": [{
          "title": "Patch 1.8",
          "description": "New maps, faster matchmaking, and 40 bug fixes.",
          "url": "https://example.com/patch-1-8",
          "color": 5793266
        }]
      }
    }],
    "publishNow": true
  }'

const res = await fetch("https://api.pozy.ai/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Patch 1.8 is live. Full notes below.",
    platforms: [{
      platform: "discord",
      accountId: "66b2e19d8c3f5a7e9d0b1c2d",
      platformSpecificData: {
        channelId: "1180000000000000123",
        embeds: [{
          title: "Patch 1.8",
          description: "New maps, faster matchmaking, and 40 bug fixes.",
          url: "https://example.com/patch-1-8",
          color: 5793266,
        }],
      },
    }],
    publishNow: true,
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.post.platforms[0].platformPostUrl);

import os, requests

resp = requests.post(
    "https://api.pozy.ai/v1/posts",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "content": "Patch 1.8 is live. Full notes below.",
        "platforms": [{
            "platform": "discord",
            "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
            "platformSpecificData": {
                "channelId": "1180000000000000123",
                "embeds": [{
                    "title": "Patch 1.8",
                    "description": "New maps, faster matchmaking, and 40 bug fixes.",
                    "url": "https://example.com/patch-1-8",
                    "color": 5793266,
                }],
            },
        }],
        "publishNow": True,
    },
)
print(resp.json()["post"]["platforms"][0]["platformPostUrl"])

#Embeds

embeds sends up to 10 rich cards with or instead of content, with 6,000 characters across all embed fields. Each embed takes title, description, url, color, image, thumbnail, footer, author and fields (each { name, value, inline }). color is a decimal integer, so convert hex first (#5865F2 is 5793266).

#Polls

poll creates a native Discord poll. A poll is a message on its own and cannot carry attachments.

{
  "platform": "discord",
  "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
  "platformSpecificData": {
    "channelId": "1180000000000000123",
    "poll": {
      "question": { "text": "Which map should we rework next?" },
      "answers": [
        { "poll_media": { "text": "Harbor" } },
        { "poll_media": { "text": "Canyon" } },
        { "poll_media": { "text": "Station" } }
      ],
      "duration": 48,
      "allow_multiselect": false
    }
  }
}

#Forums and threads

• Forum channels need forumThreadName, which becomes the thread title. content is the starter message. forumAppliedTags takes up to 5 tag ids from the forum's settings (Discord has no API to list them).
• A thread under the message: threadFromMessage with name, plus optional autoArchiveDuration (60, 1440, 4320 or 10080 minutes) and rateLimitPerUser (slow mode, 0 to 21,600 seconds).
• A thread later, or with no message: Create a Discord public thread with name and an optional messageId.

#Platform fields

#Message identity

By default, messages post under the bot's own name and avatar. To post under your brand, set an account default once with Update Discord settings, or override per post with webhookUsername and webhookAvatarUrl. The per-post values win.

curl -X PATCH https://api.pozy.ai/v1/accounts/66b2e19d8c3f5a7e9d0b1c2d/discord-settings \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "webhookUsername": "Acme Updates", "webhookAvatarUrl": "https://pozy.ai/media/acme-avatar.png" }'

A name must be 1 to 80 characters and cannot contain "clyde" or "discord". An empty string resets it to the default. The same call can move the account to another channelId.

#Edit and delete

Edit published post replaces the text of a published message, with no time limit, and keeps the message id. To remove a published message, call Delete a Discord channel message with the accountId. Deleting a draft or scheduled post in Pozy removes it before it is sent.

#Media requirements

Up to 10 attachments per message, each a public HTTPS URL. A poll cannot carry attachments. Upload through Media for URLs that qualify.

#Limits

Discord's own rate limits are handled for you: Pozy backs off on Discord's 429 responses, so you do not need retry logic for them.

#Analytics

Discord's bot API reports no message metrics, so Discord has no analytics in Pozy.

#Inbox

Discord is outbound only. Send a Discord Direct Message sends a 1:1 message from the bot, for onboarding, reminders or support pings. Replies are not received, because reading DMs needs a gateway connection. There are no comments.

curl -X POST https://api.pozy.ai/v1/discord/dms \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "accountId": "66b2e19d8c3f5a7e9d0b1c2d", "userId": "1170000000000000456", "content": "Your beta access is ready. Check #welcome to get started." }'

userId is the recipient's numeric id, not a username. Find it with Search Discord guild members, which prefix-matches usernames and nicknames. The bot can only DM people who share a server with it and have not turned off DMs from non-friends. Each DM counts as an outbound message on your bill. See Pricing.

#Server management

#Errors you may see

A post can be accepted by Pozy and still fail on Discord. Check post.status and platforms[].errorMessage in the response. Errors covers the error format.

#Endpoints

#Webhook events