Warpcast (Farcaster) Settings

Creating the OAuth app and connecting a channel: Warpcast (Farcaster) setup guide.

Overview

Warpcast is a client for the Farcaster protocol, a decentralized social network. When posting to Warpcast, you can specify which channels to post to.

The __type identifier is spelled wrapcast, not warpcast. That is the value GET /integrations returns and the one the settings schema is keyed on. On POST /posts the server overwrites __type with the channel’s own identifier, so a misspelling is ignored rather than refused. The settings also use subreddit as the field name for historical reasons, but it refers to Farcaster channels.

Settings Schema

{
  "__type": "wrapcast",
  "subreddit": [
    {
      "value": {
        "id": "channel-id"
      }
    }
  ]
}

Properties

Property	Type	Required	Description
`__type`	string	✅	Must be `"wrapcast"`
`subreddit`	array	❌	Array of channel targets
`subreddit[].value.id`	string	✅	Channel ID

Examples

Simple cast (no channel)

{
  "type": "now",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-warpcast-integration-id"
      },
      "value": [
        {
          "content": "Hello Farcaster! 👋",
          "image": []
        }
      ],
      "settings": {
        "__type": "wrapcast"
      }
    }
  ]
}

Cast to a specific channel

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-warpcast-integration-id"
      },
      "value": [
        {
          "content": "Check out this new open-source project! 🚀",
          "image": []
        }
      ],
      "settings": {
        "__type": "wrapcast",
        "subreddit": [
          {
            "value": {
              "id": "developers"
            }
          }
        ]
      }
    }
  ]
}

Cast to multiple channels

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-warpcast-integration-id"
      },
      "value": [
        {
          "content": "Excited to announce our new feature! Built with the community in mind.",
          "image": []
        }
      ],
      "settings": {
        "__type": "wrapcast",
        "subreddit": [
          {
            "value": {
              "id": "announcements"
            }
          },
          {
            "value": {
              "id": "builders"
            }
          }
        ]
      }
    }
  ]
}

Cast with image

{
  "type": "now",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-warpcast-integration-id"
      },
      "value": [
        {
          "content": "New design preview! What do you think? 🎨",
          "image": [
            {
              "id": "img-123",
              "path": "https://uploads.postqueen.ai/design.png"
            }
          ]
        }
      ],
      "settings": {
        "__type": "wrapcast",
        "subreddit": [
          {
            "value": {
              "id": "design"
            }
          }
        ]
      }
    }
  ]
}

Notes

Channel IDs are the names/slugs of Farcaster channels
You can post without specifying channels (posts to your main feed)
You can post to multiple channels simultaneously
Images are supported and will be displayed as embeds

Getting Started

Endpoints

Posting settings by platform

Build on PostQueen

Overview

Settings Schema

Properties

Examples

Simple cast (no channel)

Cast to a specific channel

Cast to multiple channels

Cast with image

Notes

​Overview

​Settings Schema

​Properties

​Examples

​Simple cast (no channel)

​Cast to a specific channel

​Cast to multiple channels

​Cast with image

​Notes

Overview

Settings Schema

Properties

Examples

Simple cast (no channel)

Cast to a specific channel

Cast to multiple channels

Cast with image

Notes