# SendIt

> Post to LinkedIn, X, Threads, Bluesky, Facebook, Instagram, TikTok, YouTube, Pinterest and more at once through SendIt: publish now or schedule for later, check a post against each network's rules first, and read back how posts performed.

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/sendit

## Actions

### Cancel a scheduled post

Cancel a scheduled post so it never goes out.

**Inputs**

- Scheduled post ID (`schedule_id`, text, required): The 'schedule_id' from a 'Schedule a post' step, or an 'id' from 'List scheduled posts'.

**Outputs**

- `cancelled` (true/false): Always true: when SendIt cannot cancel the post, the step fails instead.
- `message` (text): SendIt's confirmation, such as 'Scheduled post cancelled'.
- `schedule_id` (text): The id of the post that was cancelled.

**Example output**

```json
{
  "cancelled": true,
  "message": "Scheduled post cancelled",
  "schedule_id": "sch_8f2a1c"
}
```

### Get a connect link

The link that connects a social network to your SendIt account, to open in a browser or send to whoever owns the account. Says so when it is already connected.

**Inputs**

- Network (`platform`, text, required): The network to connect. One of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.

**Outputs**

- `action_type` (text): What connecting takes, such as oauth_redirect: open the link and approve access on the network.
- `already_connected` (true/false): True when this SendIt account already has the network.
- `auth_method` (text): How the network connects to SendIt, such as oauth2.
- `fields` (list): What to fill in, for a network connected by typing details in rather than signing in. Empty for most networks.
- `instructions` (text): SendIt's instructions for connecting, such as 'Open the link and approve access on LinkedIn.'
- `note` (text): Anything SendIt adds about connecting this network.
- `platform` (text): The network's id, such as linkedin or x.
- `platform_name` (text): The network's name, such as LinkedIn.
- `reconnect_url` (text): The link that reconnects the network when it is already connected. Empty otherwise.
- `url` (text): The link that connects the network, or reconnects it when it is already connected.
- `username` (text): The connected account's name, when it is connected.

**Example output**

```json
{
  "action_type": "oauth_redirect",
  "already_connected": false,
  "auth_method": "oauth2",
  "fields": [],
  "instructions": "Open the link and approve access on LinkedIn.",
  "note": null,
  "platform": "linkedin",
  "platform_name": "LinkedIn",
  "reconnect_url": null,
  "url": "https://sendit.infiniteappsai.com/api/v1/connect/linkedin?connect_token=ct_abc",
  "username": null
}
```

### Get best times to post

The days and hours your posts on a network did best, from your own posting history. Empty until there is enough history.

**Inputs**

- Network (`platform`, text, required): The network to look at. One of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.
- How many (`limit`, number): At most this many times. SendIt's default is 5. At least 1.

**Outputs**

- `best_times` (list): The days and hours your posts on the network did best. Empty until there is enough history.
- `count` (number): How many times are listed.
- `platform` (text): The id of the network looked at.

**Example output**

```json
{
  "best_times": [
    {
      "avg_engagement": 4.2,
      "day_of_week": "Tuesday",
      "hour": 9,
      "sample_size": 12,
      "timezone": "UTC"
    }
  ],
  "count": 1,
  "platform": "linkedin"
}
```

### Get network requirements

A network's rules for posts: text limit, image and video formats, sizes and lengths. Which rules are listed differs per network.

**Inputs**

- Network (`platform`, text, required): The network to look up. One of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.

**Outputs**

- `name` (text): The network's name, such as LinkedIn.
- `notes` (list): SendIt's notes on the network's rules, such as 'Images up to 5 MB'.
- `platform` (text): The network's id, such as linkedin or x.
- `requirements` (object): Every rule SendIt lists for the network, under SendIt's own names, such as imageFormats and videoLimit. Which rules appear differs per network.
- `text_limit` (number): The most characters a post's text can have there.

**Example output**

```json
{
  "name": "LinkedIn",
  "notes": [
    "Images up to 5 MB"
  ],
  "platform": "linkedin",
  "requirements": {
    "imageFormats": [
      "jpg",
      "png",
      "gif"
    ],
    "name": "LinkedIn",
    "notes": [
      "Images up to 5 MB"
    ],
    "platform": "linkedin",
    "rateLimit": "150 posts per day",
    "textLimit": 3000,
    "videoLimit": "10 minutes"
  },
  "text_limit": 3000
}
```

### Get network settings

The extra settings a network takes in 'Network settings' when publishing or scheduling, as a JSON Schema, and which of them are required.

**Inputs**

- Network (`platform`, text, required): The network to look up. One of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.

**Outputs**

- `auth_method` (text): How the network connects to SendIt, such as oauth2.
- `connector_mode` (text): How SendIt reaches the network, such as official.
- `name` (text): The network's name, such as LinkedIn.
- `platform` (text): The network's id, such as linkedin or x.
- `required_fields` (list): The settings every post to this network needs, such as boardId for Pinterest.
- `schema` (object): A JSON Schema of the settings the network takes: what to put under its id in 'Network settings'.

**Example output**

```json
{
  "auth_method": "oauth2",
  "connector_mode": "official",
  "name": "Pinterest",
  "platform": "pinterest",
  "required_fields": [
    "boardId"
  ],
  "schema": {
    "properties": {
      "boardId": {
        "type": "string"
      }
    },
    "required": [
      "boardId"
    ],
    "type": "object"
  }
}
```

### Get post analytics

Impressions, reach, likes, comments, shares and clicks for recent posts on one network. Which numbers a network reports varies; LinkedIn and Bluesky cover only posts made through SendIt.

**Inputs**

- Network (`platform`, text, required): The network to report on. One of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.

**Outputs**

- `count` (number): How many posts are listed.
- `platform` (text): The id of the network reported on.
- `posts` (list): Recent posts on that network, with their numbers.
- `warnings` (list): SendIt's notes on what the numbers leave out, such as posts made outside SendIt. Empty when there are none.

**Example output**

```json
{
  "count": 1,
  "platform": "linkedin",
  "posts": [
    {
      "clicks": 18,
      "comments": 6,
      "engagement_rate": 4.5,
      "impressions": 1520,
      "likes": 42,
      "post_id": "urn:li:share:7251234567890",
      "post_url": "https://www.linkedin.com/feed/update/urn:li:share:7251234567890",
      "published_at": "2026-10-15T09:00:00Z",
      "reach": 1210,
      "saves": 0,
      "shares": 3,
      "views": 0
    }
  ],
  "warnings": []
}
```

### Get supported networks

Every network SendIt supports, whether it is enabled right now, and how it connects.

**Inputs**: None.

**Outputs**

- `enabled_count` (number): How many of them are enabled right now.
- `enabled_platforms` (list): The ids of the networks enabled right now.
- `generated_at` (text): When SendIt drew up this list.
- `platforms` (list): Every network SendIt offers.
- `release_mode` (text): SendIt's name for the set of networks it offers, such as full_catalog.
- `total_count` (number): How many networks SendIt offers.

**Example output**

```json
{
  "enabled_count": 22,
  "enabled_platforms": [
    "linkedin"
  ],
  "generated_at": "2026-10-18T10:00:00Z",
  "platforms": [
    {
      "auth_method": "oauth2",
      "category": "social",
      "circuit_status": "closed",
      "connector_mode": "official",
      "enabled": true,
      "id": "linkedin",
      "name": "LinkedIn"
    }
  ],
  "release_mode": "full_catalog",
  "total_count": 22
}
```

### List connected accounts

The social accounts connected to this SendIt account, and when each connection expires.

**Inputs**: None.

**Outputs**

- `accounts` (list): The social accounts in this SendIt account.
- `connected_platforms` (list): The id of each network with a connected account, once each, as the Networks field of other SendIt steps takes them.
- `count` (number): How many accounts are listed.

**Example output**

```json
{
  "accounts": [
    {
      "connected": true,
      "expires_at": "2026-12-15T00:00:00Z",
      "platform": "linkedin",
      "platform_name": "LinkedIn profile",
      "username": "Ada Lovelace"
    }
  ],
  "connected_platforms": [
    "linkedin"
  ],
  "count": 1
}
```

### List scheduled posts

List the posts waiting to go out. Posts already published or cancelled are not listed.

**Inputs**

- Network (`platform`, text): Only posts going to this network. All if blank. One of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.

**Outputs**

- `count` (number): How many posts are listed.
- `posts` (list): The posts waiting to go out.

**Example output**

```json
{
  "count": 1,
  "posts": [
    {
      "content": {
        "text": "Our new release is out."
      },
      "created_at": "2026-10-18T10:00:00Z",
      "id": "sch_8f2a1c",
      "platforms": [
        "linkedin"
      ],
      "scheduled_time": "2026-11-02T09:00:00Z",
      "status": "pending",
      "text": "Our new release is out."
    }
  ]
}
```

### List webhooks

The webhooks SendIt calls when posts and accounts change.

**Inputs**: None.

**Outputs**

- `count` (number): How many webhooks are listed.
- `webhooks` (list): The webhooks set up in SendIt.

**Example output**

```json
{
  "count": 1,
  "webhooks": [
    {
      "active": true,
      "created_at": "2026-10-18T10:00:00Z",
      "events": [
        "post.published",
        "post.failed"
      ],
      "failure_count": 0,
      "id": "wh_3b9d2e",
      "last_triggered_at": null,
      "url": "https://example.com/hooks/sendit"
    }
  ]
}
```

### Publish a post

Post now to one or more social networks through SendIt. If some networks fail, the step still succeeds with the posts that went out and lists the failures in 'errors'; it fails only when nothing was posted.

**Inputs**

- Networks (`platforms`, list, required): Where to post. Each network must be connected in your SendIt account first. One or more of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.
- Text (`text`, text, required): The post, up to 4,000 characters. Each network's own limit still applies: 280 on X, 3,000 on LinkedIn.
- Image or video URL (`media_url`, text): A public https:// link straight to one image or video. Instagram and Pinterest need an image; YouTube and TikTok need a video.
- More image URLs (`media_urls`, list): Several public https:// links, for a carousel or gallery: up to 20 together with the URL above.
- Media type (`media_type`, text): What the media is. SendIt works it out by default. One of: `auto` (Work it out from the file), `image`, `video`.
- Network settings (`platform_settings`, object): Extra settings per network, keyed by network id. 'Get network settings' lists what each network takes, such as a Pinterest board.
- X thread replies (`thread_tweets`, list): X only: further posts that follow the first one as a thread, each up to 280 characters.

**Outputs**

- `errors` (list): SendIt's reason for each network that failed. Empty when every network posted.
- `partial` (true/false): True when the post went out on some networks but not all of them. 'errors' says why the others failed.
- `post_urls` (list): A link to each post that went out, for the networks that gave one.
- `published_count` (number): How many networks the post went out on.
- `results` (list): One entry per network SendIt tried, including any that failed.
- `success` (true/false): Whether SendIt called the request a success. It can be false when some networks failed; 'errors' says why.

**Example output**

```json
{
  "errors": [],
  "partial": false,
  "post_urls": [
    "https://www.linkedin.com/feed/update/urn:li:share:7251234567890"
  ],
  "published_count": 1,
  "results": [
    {
      "cost_estimate": null,
      "platform": "linkedin",
      "platform_post_id": "urn:li:share:7251234567890",
      "platform_post_ids": [],
      "post_type": "text",
      "post_url": "https://www.linkedin.com/feed/update/urn:li:share:7251234567890"
    }
  ],
  "success": true
}
```

### Publish a scheduled post now

Publish a pending scheduled post straight away instead of waiting for its time.

**Inputs**

- Scheduled post ID (`schedule_id`, text, required): The 'schedule_id' from a 'Schedule a post' step, or an 'id' from 'List scheduled posts'.

**Outputs**

- `errors` (list): SendIt's reason for each network that failed. Empty when every network posted.
- `partial` (true/false): True when the post went out on some networks but not all of them. 'errors' says why the others failed.
- `post_urls` (list): A link to each post that went out, for the networks that gave one.
- `published_count` (number): How many networks the post went out on.
- `results` (list): One entry per network SendIt tried, including any that failed.
- `schedule_id` (text): The id of the scheduled post that went out.
- `success` (true/false): Whether SendIt called the request a success. It can be false when some networks failed; 'errors' says why.

**Example output**

```json
{
  "errors": [],
  "partial": false,
  "post_urls": [
    "https://www.linkedin.com/feed/update/urn:li:share:7251234567890"
  ],
  "published_count": 1,
  "results": [
    {
      "cost_estimate": null,
      "platform": "linkedin",
      "platform_post_id": "urn:li:share:7251234567890",
      "platform_post_ids": [],
      "post_type": "text",
      "post_url": "https://www.linkedin.com/feed/update/urn:li:share:7251234567890"
    }
  ],
  "schedule_id": "sch_8f2a1c",
  "success": true
}
```

### Schedule a post

Schedule a post to go out on one or more networks at a later time. SendIt checks the content now, so a post a network would refuse fails here rather than later.

**Inputs**

- Networks (`platforms`, list, required): Where to post. Each network must be connected in your SendIt account first. One or more of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.
- Text (`text`, text, required): The post, up to 4,000 characters. Each network's own limit still applies: 280 on X, 3,000 on LinkedIn.
- Post at (`scheduled_time`, date and time, required): When to post. It must be in the future.
- Time zone (`time_zone`, text): The time zone 'Post at' is in, such as America/New_York. UTC if left blank.
- Image or video URL (`media_url`, text): A public https:// link straight to one image or video. Instagram and Pinterest need an image; YouTube and TikTok need a video.
- More image URLs (`media_urls`, list): Several public https:// links, for a carousel or gallery: up to 20 together with the URL above.
- Media type (`media_type`, text): What the media is. SendIt works it out by default. One of: `auto` (Work it out from the file), `image`, `video`.
- Network settings (`platform_settings`, object): Extra settings per network, keyed by network id. 'Get network settings' lists what each network takes, such as a Pinterest board.
- X thread replies (`thread_tweets`, list): X only: further posts that follow the first one as a thread, each up to 280 characters.

**Outputs**

- `platforms` (list): The ids of the networks it will post to.
- `schedule_id` (text): The scheduled post's id. 'Cancel a scheduled post' and 'Publish a scheduled post now' take it.
- `scheduled_time` (text): When it will post, in UTC, such as 2026-11-02T09:00:00Z.
- `status` (text): SendIt's status for the post, such as pending.

**Example output**

```json
{
  "platforms": [
    "linkedin"
  ],
  "schedule_id": "sch_8f2a1c",
  "scheduled_time": "2026-11-02T09:00:00Z",
  "status": "pending"
}
```

### Score content

Score a draft from 0 to 100 for each network, on length, hashtags, timing, media and wording, with suggestions to improve it.

**Inputs**

- Networks (`platforms`, list, required): Where to post. Each network must be connected in your SendIt account first. One or more of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.
- Text (`text`, text, required): The post, up to 4,000 characters. Each network's own limit still applies: 280 on X, 3,000 on LinkedIn.
- Planned time (`scheduled_time`, date and time): When you plan to post, to score the timing.
- Has an image or video (`has_media`, true/false): Tick if the post will carry an image or video. Default: `false`.

**Outputs**

- `count` (number): How many scores are listed.
- `scores` (list): One score per network, or a single score for every network chosen when SendIt scores the post as a whole.

**Example output**

```json
{
  "count": 1,
  "scores": [
    {
      "breakdown": {
        "hashtagScore": 60,
        "lengthScore": 80,
        "mediaScore": 50,
        "patternScore": 85,
        "timingScore": 90
      },
      "platform": "linkedin",
      "score": 78,
      "suggestions": [
        "Add an image to lift engagement."
      ]
    }
  ]
}
```

### Validate a media URL

Check that SendIt can fetch and use an image or video link, and get its type, size and dimensions.

**Inputs**

- Image or video URL (`media_url`, text, required): A public https:// link straight to the file.
- Folder (`folder`, text): A folder name to file the media under in SendIt.

**Outputs**

- `content_type` (text): The file's type, such as image/png.
- `dimensions` (text): Its width and height in pixels, such as 1200x630. Empty when SendIt gives none.
- `size` (text): The file's size as SendIt writes it, such as 245 KB.
- `url` (text): The media link as SendIt returned it, for the image or video URL of a post.

**Example output**

```json
{
  "content_type": "image/png",
  "dimensions": "1200x630",
  "size": "245 KB",
  "url": "https://example.com/launch.png"
}
```

### Validate content

Check a post against each network's rules without posting it. 'valid' is false, with the reasons in 'problems', when a network would refuse it.

**Inputs**

- Networks (`platforms`, list, required): Where to post. Each network must be connected in your SendIt account first. One or more of: `x` (X (Twitter)), `linkedin` (LinkedIn profile), `linkedin-page` (LinkedIn Page), `facebook`, `instagram`, `threads`, `bluesky`, `mastodon`, `nostr`, `youtube`, and 12 more.
- Text (`text`, text, required): The post, up to 4,000 characters. Each network's own limit still applies: 280 on X, 3,000 on LinkedIn.
- Image or video URL (`media_url`, text): A public https:// link straight to one image or video. Instagram and Pinterest need an image; YouTube and TikTok need a video.
- More image URLs (`media_urls`, list): Several public https:// links, for a carousel or gallery: up to 20 together with the URL above.
- Media type (`media_type`, text): What the media is. SendIt works it out by default. One of: `auto` (Work it out from the file), `image`, `video`.

**Outputs**

- `platforms` (list): One entry per network checked.
- `problems` (list): Every problem as one line, such as 'x: Text exceeds 280 characters'. Empty when the post is valid.
- `valid` (true/false): True when every network would accept the post.

**Example output**

```json
{
  "platforms": [
    {
      "errors": [
        {
          "actual": 312,
          "field": "text",
          "limit": 280,
          "message": "Text exceeds 280 characters"
        }
      ],
      "platform": "x",
      "valid": false
    }
  ],
  "problems": [
    "x: Text exceeds 280 characters"
  ],
  "valid": false
}
```
