Mastodon Settings - Groniz Documentation

Settings Schema

When creating a post for Mastodon, use the following settings schema:

{
  "settings": {
    "__type": "mastodon"
  }
}

Mastodon has no provider-specific settings beyond __type. Post content, images, and the schedule are configured at the post level - see the Create Post reference. The instance the post publishes to is determined by the connected integration, not the settings block.

Field	Type	Required	Description
`__type`	`string`	Yes	Must be `mastodon`

Field

Type

Required

Description

__type

string

Yes

Must be mastodon

Complete Example

Text Post

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-mastodon-integration-id"
      },
      "value": [
        {
          "content": "Hello from the Groniz API! 🐘",
          "image": []
        }
      ],
      "settings": {
        "__type": "mastodon"
      }
    }
  ]
}

Thread Post

Create a thread by adding multiple items to the value array. Each entry becomes a reply chained to the previous toot:

{
  "type": "schedule",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-mastodon-integration-id"
      },
      "value": [
        {
          "content": "1/ Starting a thread on Mastodon from the API",
          "image": []
        },
        {
          "content": "2/ Each value entry becomes a reply in the thread",
          "image": []
        }
      ],
      "settings": {
        "__type": "mastodon"
      }
    }
  ]
}

Post with Image

{
  "type": "now",
  "date": "2024-12-14T10:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": {
        "id": "your-mastodon-integration-id"
      },
      "value": [
        {
          "content": "Sharing a launch screenshot",
          "image": [
            {
              "id": "image-id",
              "path": "https://api.groniz.com/launch.png"
            }
          ]
        }
      ],
      "settings": {
        "__type": "mastodon"
      }
    }
  ]
}

​Settings Schema

​Fields

​Complete Example

​Text Post

​Thread Post

​Post with Image

Settings Schema

Fields

Complete Example

Text Post

Thread Post

Post with Image