Log inStart Free Trial
easyCoexistence Official APIs

Post to Instagram, TikTok and more social media from Google Sheets

With easyCoexistence, each row of a Google Sheet becomes a post on Instagram, TikTok, Facebook and more channels, published through each network's official API now or at the time in the row, up to 90 days ahead. Claude reads the sheet and schedules the rows, or Apps Script and n8n send each row to easyCoexistence's posts API. For LinkedIn, Claude schedules each row after you approve its post.

Reads Sheets

What Claude's Google Drive connector does with a Google Sheet, as text; the connector is available to all Claude users.

90 days

How far ahead easyCoexistence's queue takes a post, from 1 minute, copying its media when the post is scheduled.

20,000 a day

URL Fetch calls Apps Script allows a consumer Google account; a Google Workspace account gets 100,000.

6 minutes

The longest one Apps Script execution runs before Google stops it.

100 posts

API-published posts an Instagram account can make in a moving 24 hours; a carousel counts as one.

How does Claude schedule the rows of a Google Sheet?

With two connectors in one chat. Connect Claude's Google Drive connector and turn it on from the + button, under Connectors, beside the easyCoexistence connector, then ask: "Read the sheet Content calendar and schedule each row on its account at the time in its publish_at column. Show me each LinkedIn post before you schedule it." Claude reads the rows as text and calls publish_instagram_post, publish_tiktok_post or publish_facebook_post with scheduled_at for each, publish_linkedin_post the same way once you approve the post in the chat, or upload_youtube_video with publish_at for a YouTube row.

In ChatGPT, with easyCoexistence added as a custom MCP server, paste the rows into the chat instead. Either way the posts wait in easyCoexistence's queue and go out at their time with the chat closed, and list_scheduled_posts shows what was queued.

1Google Drive connectorClaude reads the rows
2easyCoexistence connectorOne publish tool call per row, with scheduled_at
3The queueMedia copied, the post held until its time
4The networkPublished through its official API

How should the sheet be laid out?

One row per post and one column per field, so Claude or a script reads each row the same way. account_id names the account, as list_social_accounts returns it; the Partner API calls the same ID a channel. publish_at holds a date and time with its offset, such as 2026-11-20T09:00:00-03:00, or stays empty to post at once. media_url links to the file itself over HTTPS, and easyCoexistence copies the file when the row is scheduled, so the link only has to work at that moment.

Add a title column for TikTok photo posts and a link column for Facebook and LinkedIn when you need them. The status column is where Apps Script or n8n writes what happened. Both post the rows they read without asking anyone, so keep LinkedIn rows off their Posts sheet and leave those rows to Claude.

account_idThe Instagram, TikTok or Facebook account, or a LinkedIn one for Claude, from list_social_accounts
publish_atISO 8601 with an offset, 1 minute to 90 days ahead; empty posts now
textThe caption, message or commentary
media_urlAn HTTPS link that returns the image or video file
media_typeimage or video, needed when the link has no file extension
statusWritten back: sent, or the error the API returned

How does Apps Script send each row to easyCoexistence?

With UrlFetchApp, from Extensions, then Apps Script, in the sheet itself. Create a Partner API key in the dashboard under Profile, Developers, which begins ec_live_, and save it as a script property rather than in the code. The function below reads the rows with no status, sends each one to POST /api/v1/channels/<account_id>/posts with its text, media and publish_at, and writes sent or the error into the status column. Its Idempotency-Key header, a hash of the row, is honored by easyCoexistence, so a call repeated after a failed run does not queue the post twice.

Run install once to check the sheet on a timer; everyMinutes accepts 1, 5, 10, 15 or 30. A long sheet is worked through over several runs, which the status column makes safe.

Apps Script: send each new row to easyCoexistence's posts API
// Project Settings > Script properties: EC_API_KEY = ec_live_...
// Sheet "Posts", Instagram, TikTok and Facebook rows only:
// A account_id | B publish_at | C text | D media_url | E media_type | F status
function queueRows() {
  const key = PropertiesService.getScriptProperties().getProperty("EC_API_KEY");
  const sheet = SpreadsheetApp.getActive().getSheetByName("Posts");
  const rows = sheet.getDataRange().getValues();
  for (let i = 1; i < rows.length; i++) {
    const [account, at, text, mediaUrl, mediaType, status] = rows[i];
    if (!account || status) continue;
    const post = { text: String(text) };
    if (mediaUrl) post.media = [{ url: String(mediaUrl), type: mediaType || undefined }];
    if (at) post.publish_at = at instanceof Date ? at.toISOString() : String(at);
    const rowKey = Utilities.base64EncodeWebSafe(Utilities.computeDigest(
      Utilities.DigestAlgorithm.SHA_256, [account, post.publish_at, text, mediaUrl].join("|")));
    const res = UrlFetchApp.fetch("https://easycoexistence.com/api/v1/channels/" + account + "/posts", {
      method: "post",
      contentType: "application/json",
      headers: { Authorization: "Bearer " + key, "Idempotency-Key": rowKey },
      payload: JSON.stringify(post),
      muteHttpExceptions: true,
    });
    const code = res.getResponseCode();
    const ok = code >= 200 && code < 300;
    sheet.getRange(i + 1, 6).setValue(ok ? "sent" : code + ": " + res.getContentText().slice(0, 200));
  }
}

// Run once to check the sheet on a 15-minute timer
function install() {
  ScriptApp.newTrigger("queueRows").timeBased().everyMinutes(15).create();
}

How does n8n post the rows?

With three nodes and no code. A Google Sheets Trigger set to Row added starts the workflow when a row is added. An HTTP Request node sends it to POST https://easycoexistence.com/api/v1/channels/{{ $json.account_id }}/posts, with a Header Auth credential holding Authorization: Bearer and the ec_live_ key, and a JSON body built from the row's columns. A Google Sheets node with Update Row then writes the outcome to the status column.

To have AI write each caption, put an AI Agent node before the HTTP Request. Or give the agent an MCP Client Tool with https://easycoexistence.com/api/mcp and OAuth2, and it calls the publish tools itself, with scheduled_at; the n8n social media guide covers that connection. Under Tools to Include, choose Selected and tick only publish_instagram_post, publish_tiktok_post and publish_facebook_post: this workflow posts with no person approving each post, so LinkedIn stays with Claude.

1Google Sheets TriggerRow added, on the Posts sheet
2HTTP RequestPOST /api/v1/channels/:id/posts
3Google SheetsUpdate Row: the status column

What does each network accept from a row?

The rules below, set by each network or by easyCoexistence's own checks, are applied when the row is scheduled, so a row that cannot go out is refused at once rather than at its posting time:

  • Instagram: one JPEG image, a carousel of 2 to 10 items, a Reel or a Story, with a caption of up to 2,200 characters. A post has no link field, so a link goes in the text.
  • TikTok: one video in MP4, MOV or WebM, 3 to 600 seconds and up to 1 GB, or 1 to 35 JPEG or WebP images with a title of up to 90 characters.
  • Facebook: text, a link, one photo or one video, with a link or a file but not both in one post.
  • LinkedIn, scheduled by Claude after you approve each post: text of up to 3,000 characters with one JPG, PNG or GIF image, or with a link and its title.
  • YouTube: a video sent with upload_youtube_video and publish_at, which YouTube keeps private until then; YouTube requires the made_for_kids setting.

How do you know a row went out?

From easyCoexistence, without opening each network. list_scheduled_posts in Claude, or GET /api/v1/posts with a status filter in code, shows each post as scheduled, publishing, processing, published, failed or canceled, with its link once it is live. The Posts screen in the dashboard groups the same posts under Needs attention, Coming up and Published, with Cancel, Retry and Dismiss.

When a post fails, the owner gets an email, at most one per channel in 3 hours, and an events URL set in the dashboard receives post.published and post.failed, which an n8n workflow can turn into an update of the row's status. A post the network rate-limits is retried after 5 minutes, 30 minutes and 2 hours.

How to set it up

  1. Connect the accountsIn the easyCoexistence dashboard, choose New connection and sign in to the Instagram, TikTok, Facebook, LinkedIn or YouTube accounts the rows are for.
  2. Lay out the sheetGive each post a row with account_id, publish_at, text, media_url, media_type and status columns.
  3. Choose who sends itAsk Claude to schedule the rows, approving each LinkedIn post, or install the Apps Script with an ec_live_ key or build the n8n workflow for Instagram, TikTok and Facebook rows.

Common mistakes

  • Pasting a Google Drive share link as the media. It opens a Drive page, not the file, and easyCoexistence refuses a web page when the row is scheduled; use a link that returns the image or video itself.
  • Writing publish_at as 2026-11-20 09:00 with no offset. easyCoexistence refuses a time without a timezone, so add -03:00 or Z, or keep the column as a date and let the script convert it with toISOString().
  • Putting a PNG in an Instagram or TikTok row. Instagram publishes JPEG images only and TikTok photo posts take JPEG or WebP, so convert the image before it is scheduled.
  • Queueing more TikTok rows than TikTok takes in a day. Its API accepts 15 video posts and 15 photo posts per account a day, six a minute at most, so spread a busy sheet across days.
Doing this with EasyCoexistence

easyCoexistence gives your spreadsheet, and the AI agents that read it, reach to customers on Instagram, TikTok, Facebook, YouTube and more channels, each through its official API: one MCP connector for Claude and ChatGPT, a posts API for Apps Script and n8n, and a queue that publishes up to 90 days ahead, with every connection monitored 24/7. US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Do the posts go out if the sheet and the chat are closed?

Yes. A scheduled row waits in easyCoexistence's queue with its media copied, and is published at its time. Deleting the row later does not cancel the post; cancel_scheduled_post or DELETE /api/v1/posts/:id does.

Can one row post to several networks?

A post belongs to one account, so give each network its own row, or ask Claude to turn one row into a version per network and schedule each. Each connected account counts as one connection.

Can the same sheet log WhatsApp messages?

Yes, on its own tab. Messages to a connected WhatsApp number can be appended as rows through n8n, and approved templates sent from a list; the Google Sheets guide for WhatsApp covers both.

How much does easyCoexistence cost for posting from Google Sheets?

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, the same on each network. The MCP connector and the posts API are included, and the first 3 days are free.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on