- Scheduled
- Preparing your media
- Instagram is processing
- Ready, waiting for the scheduled time
- Publishing
- Published
Permalink
https://www.instagram.com/p/EXAMPLE/
Instagram firstSocial publishing API
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" }
]
}'const res = await fetch("https://api.relayport.dev/posts", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.RELAYPORT_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
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" }],
}),
});
const { data: post } = await res.json();import os, requests
key = os.environ["RELAYPORT_API_KEY"]
res = requests.post(
"https://api.relayport.dev/posts",
headers={"Authorization": f"Bearer {key}"},
json={
"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" },
],
},
)
post = res.json()["data"]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.
Permalink
https://www.instagram.com/p/EXAMPLE/
01How it works
No SDK to install. Plain HTTPS and JSON, with an API key from the dashboard.
01
Your user signs in to Instagram and approves two permissions: basic profile and content publishing.
02
One API request: media, caption, time.
03
Posts, per-target status and permalinks, by polling the API or in the Dashboard.
02Retries
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.
01Agent tool call
The agent asks for one post.
02Timeout
The answer never reaches the agent.
03The same call again
The agent tries once more.
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.
The permalink is on the receipt.
The receipt lists what we checked.
03Receipts
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.
Permalink
https://www.instagram.com/p/EXAMPLE/
04Unconfirmed
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.
{
"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"
]
}
}05Platforms
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.
Business and Creator accounts
Checked before anything is sent
More networks are planned. We build the next one people ask for most.
We store Instagram access tokens encrypted and delete them when you disconnect. You can delete your data at any time from the dashboard or by email.
06Questions
Instagram, through professional accounts (Business or Creator) connected by logging in with Instagram or Facebook. Other networks follow, in order of demand.
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.
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.
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.
No. Relay Port is an independent service made by Bypass Inc.. It is not affiliated with, endorsed by or sponsored by Meta Platforms, Inc.
Create a workspace, connect an Instagram professional account and make your first call.