Skip to content

Instagram firstSocial publishing API

Every post gets a receipt.

Relay Port is one REST API to schedule and publish social posts. It makes the platform's publish call at most once per target, records every step, and tells you when the platform's answer is unclear.

For developers, AI-agent builders and agencies.

curl -X POST https://api.relayport.dev/posts \
  -H "Authorization: Bearer $RELAYPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "schedule",
    "scheduledAt": "2026-12-01T09:00:00+09:00",
    "text": "Winter menu, out Monday.",
    "media": [
      { "mediaId": "0193d29f-0c4a-7e21-a5b8-2c9d8e7f6a01" },
      { "mediaId": "0193d29f-0c4a-7e22-b6c9-3d0e9f8a7b02" }
    ],
    "platformData": { "instagram": { "contentType": "carousel" } },
    "targets": [
      { "accountId": "0193c8e1-77a2-7b05-8d14-6a5b4c3d2e10" }
    ]
  }'

Response201 Created

{
  "data": {
    "id": "0193d2a4-6b1e-7c3f-8a92-4f1e2d3c5b60",
    "status": "scheduled",
    "scheduledAt": "2026-12-01T00:00:00.000Z",
    "targets": [
      {
        "id": "0193d2a4-6b1f-7d40-9b13-5e2f3a4c6d71",
        "platform": "instagram",
        "status": "scheduled",
        "permalink": null
      }
    ]
  }
}

Example data. Fictional IDs, abridged.

GET /posts/{id}/eventsReceipt

  1. Scheduled
  2. Preparing your media
  3. Instagram is processing
  4. Ready, waiting for the scheduled time
  5. Publishing
  6. Published

Permalink

https://www.instagram.com/p/EXAMPLE/

Published

What the API promises

1publish call
At most one per target, made by us on our own.
24hour duplicate guard
Identical content to the same account is refused unless you allow it.
3honest outcomes
Published, failed, or unconfirmed with the evidence we gathered.
1receipt per target
Every step timestamped, in the API and in the dashboard.

01How it works

Three steps from an account to a receipt.

No SDK to install. Plain HTTPS and JSON, with an API key from the dashboard.

  1. 01

    Connect.

    Your user signs in to Instagram and approves two permissions: basic profile and content publishing.

  2. 02

    Send.

    One API request: media, caption, time.

  3. 03

    Get receipts.

    Posts, per-target status and permalinks, by polling the API or in the Dashboard.

02Retries

Your agent can retry. We still send it once.

Agents time out and call again. Networks time out after they accept a post. Relay Port keeps the two apart. Identical content to the same account within 24 hours is refused unless you allow it. And we never send a publish call a second time on our own.

If a platform's answer is ambiguous, the post is marked unconfirmed and we show what we checked. We never guess by sending it again. A retry of an unconfirmed post is a choice you make, after seeing the evidence.

  1. 01Agent tool call

    The agent asks for one post.

  2. 02Timeout

    The answer never reaches the agent.

  3. 03The same call again

    The agent tries once more.

  4. 04Refused as a duplicate

    Identical content to the same account within 24 hours returns 409 DuplicateContent unless the call allows it.

Then the target timeline settles in one of two ways.

  • Published

    The permalink is on the receipt.

  • Unconfirmed

    The receipt lists what we checked.

03Receipts

A receipt for every target.

Every post you send becomes one receipt per account. You see each step: container created, processing, published with the permalink, or failed with Instagram's error code one field away. If Instagram's answer is unclear, you see unconfirmed and the evidence, not a silent success.

  • Target · InstagramExample

    1. Container created
    2. Processing
    3. Publish sent
    4. Published

    Permalink

    https://www.instagram.com/p/EXAMPLE/

    Published
  • Target · InstagramExample

    1. Checked before sending
    2. Failed: carousel must have 2 to 10 items. Not sent. Nothing published.

    Failed
  • Target · InstagramExample

    1. Container created
    2. Processing
    3. Publish sent
    4. Unconfirmed: Instagram's answer was unclear

    Unconfirmed

04Unconfirmed

What unconfirmed means

Instagram sometimes accepts a post and then fails to answer. We read Instagram to find out what happened. If we still cannot tell, the target is unconfirmed.

We never send the same post twice on our own, and we tell you when a platform's response is ambiguous.

A retry is your choice, after you read the evidence. A retry of an unconfirmed post may create a duplicate on Instagram.

One target of GET /posts/{id}
{
  "platform": "instagram",
  "status": "unconfirmed",
  "permalink": null,
  "error": {
    "code": "publish_unconfirmed",
    "action": "check_platform",
    "retryByUser": false
  },
  "reconciliation": {
    "evidence": [
      "container FINISHED at 14:08:50; no matching media at 14:08:50",
      "container FINISHED at 14:10:50; no matching media at 14:10:50",
      "container FINISHED at 14:18:50; 1 unattributable media at 14:18:50"
    ]
  }
}
Example. Fictional values, abridged: 3 of up to 6 reads, 2 minutes apart.

05Platforms

Instagram first.

Connect an Instagram professional account by logging in with Instagram or Facebook, then publish now or at a time you choose. Other networks follow, in order of demand.

Instagram

Business and Creator accounts

  • Post
  • Carousel

Checked before anything is sent

Caption
Up to 2,200 characters
Carousel
2 to 10 images
Image
JPEG, up to 8 MB
Scheduling
1 min to 365 days ahead

More networks are planned. We build the next one people ask for most.

06Questions

Plain answers.

Which platforms does Relay Port publish to?

Instagram, through professional accounts (Business or Creator) connected by logging in with Instagram or Facebook. Other networks follow, in order of demand.

What if my request times out and my agent sends it again?

Identical content to the same account within 24 hours is refused with 409 DuplicateContent unless the call sets allowDuplicate. And we never send a publish call a second time on our own.

What does unconfirmed mean?

Instagram sometimes accepts a post and then fails to answer. We read Instagram to find out what happened. If we still cannot tell, the target is unconfirmed and its receipt lists what we checked.

Can I retry a post that did not go out?

Yes. A retry moves a failed target to a new revision and schedules it again. An unconfirmed target is retried only when you ask for it with includeUnconfirmed, because it may already be live.

Is Relay Port made by Meta?

No. Relay Port is an independent service made by Bypass Inc.. It is not affiliated with, endorsed by or sponsored by Meta Platforms, Inc.

Send one post. Read its receipt.

Create a workspace, connect an Instagram professional account and make your first call.