Publishing API
Post once. Know exactly what happened.
Relay Port is a social media publishing and scheduling API, for developers, AI-agent builders and agencies. Instagram is the first platform.
What Relay Port does
Publish and schedule to Instagram
Connect an Instagram professional account by logging in with Instagram or Facebook, then publish images and carousels now or at a time you choose.
A receipt for every post
Every post gets a status you can read: published, failed, or unconfirmed with the evidence we gathered. We send each post once and tell you when Instagram's answer is unclear.
Your data, your call
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.
Retries
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
Agent tool call
The agent asks for one post.
2
Timeout
The answer never reaches the agent.
3
The same call again
The agent tries once more.
4
Refused 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.
Unconfirmed
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.
Example. Fictional values, abridged: 3 of up to 6 reads, 2 minutes apart.
Receipts
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.
- PublishedExample
Container created
Processing
Publish sent
Published
Permalink: https://www.instagram.com/p/EXAMPLE/
- FailedExample
Checked before sending
Failed: carousel must have 2 to 10 items. Not sent. Nothing published.
- UnconfirmedExample
Container created
Processing
Publish sent
Unconfirmed: Instagram's answer was unclear
How it works
Three steps
01
Connect.
Your user signs in to Instagram and approves two permissions: basic profile and content publishing.
02
Send.
One API request: media, caption, time.
03
Get receipts.
Posts, per-target status and permalinks, by polling the API or in the Dashboard.