Solutions
Hosted connect links, one API.
Let your customers connect their own Instagram accounts through a hosted link, then publish for them through one API.
If your product lets customers post to Instagram, you need two things: a way for them to connect an account, and an API that publishes for them. Relay Port gives you both, so you do not build a login flow or track platform rules yourself.
Publishing returns a receipt for every target, so your product can show a customer exactly what happened, including the platform's own error when a post fails.
A workflow
How it goes, step by step.
- 01Your backend creates a connect link for the customer's brand and sends the customer to it.
- 02The customer logs in with Instagram on a hosted page. Meta shows its own consent screen, and you never handle the customer's credentials.
- 03The customer returns to your redirectUri with status, accountIds, brandId and your state.
- 04Your backend publishes for the connected account with POST /posts and its own API key.
- 05Your product reads each target's receipt and shows the customer what happened.
Create a post
curl -X POST https://api.relayport.dev/posts \
-H "Authorization: Bearer $RELAYPORT_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: winter-menu-2026-12-01" \
-d '{
"mode": "schedule",
"scheduledAt": "2026-12-01T09:00:00+09:00",
"text": "Our winter menu is here.",
"media": [
{ "mediaId": "0193d29f-0c4a-7e21-a5b8-2c9d8e7f6a01" },
{ "mediaId": "0193d29f-0c4a-7e22-b6c9-3d0e9f8a7b02" }
],
"platformData": { "instagram": { "contentType": "carousel" } },
"targets": [
{ "accountId": "0193c8e1-77a2-7b05-8d14-6a5b4c3d2e10" },
{ "accountId": "0193c8e1-77a2-7b06-9e25-7b6c5d4e3f21" }
]
}'const apiKey = "YOUR_API_KEY";
const res = await fetch("https://api.relayport.dev/posts", {
method: "POST",
headers: {
Authorization: `Bearer ${apiKey}`,
"Content-Type": "application/json",
"Idempotency-Key": "winter-menu-2026-12-01",
},
body: JSON.stringify({
mode: "schedule",
scheduledAt: "2026-12-01T09:00:00+09:00",
text: "Our winter menu is here.",
media: [
{ mediaId: "0193d29f-0c4a-7e21-a5b8-2c9d8e7f6a01" },
{ mediaId: "0193d29f-0c4a-7e22-b6c9-3d0e9f8a7b02" },
],
platformData: { instagram: { contentType: "carousel" } },
targets: [
{ accountId: "0193c8e1-77a2-7b05-8d14-6a5b4c3d2e10" },
{ accountId: "0193c8e1-77a2-7b06-9e25-7b6c5d4e3f21" },
],
}),
});
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}",
"Idempotency-Key": "winter-menu-2026-12-01",
},
json={
"mode": "schedule",
"scheduledAt": "2026-12-01T09:00:00+09:00",
"text": "Our winter menu is here.",
"media": [
{ "mediaId": "0193d29f-0c4a-7e21-a5b8-2c9d8e7f6a01" },
{ "mediaId": "0193d29f-0c4a-7e22-b6c9-3d0e9f8a7b02" },
],
"platformData": { "instagram": { "contentType": "carousel" } },
"targets": [
{ "accountId": "0193c8e1-77a2-7b05-8d14-6a5b4c3d2e10" },
{ "accountId": "0193c8e1-77a2-7b06-9e25-7b6c5d4e3f21" },
],
},
)
post = res.json()["data"]Response201 Created
{
"data": {
"id": "0193d2a4-6b1e-7c3f-8a92-4f1e2d3c5b60",
"brandId": "0193c8d0-2f6a-7a11-9c04-1b2a3c4d5e60",
"status": "scheduled",
"mode": "schedule",
"text": "Our winter menu is here.",
"title": null,
"firstComment": null,
"scheduledAt": "2026-12-01T00:00:00.000Z",
"queueId": null,
"revision": 1,
"source": "api",
"media": [
{
"mediaId": "0193d29f-0c4a-7e21-a5b8-2c9d8e7f6a01",
"position": 0
},
{
"mediaId": "0193d29f-0c4a-7e22-b6c9-3d0e9f8a7b02",
"position": 1
}
],
"platformData": { "instagram": { "contentType": "carousel" } },
"stagger": null,
"metadata": {},
"targets": [
{
"id": "0193d2a4-6b1f-7d40-9b13-5e2f3a4c6d71",
"accountId": "0193c8e1-77a2-7b05-8d14-6a5b4c3d2e10",
"platform": "instagram",
"status": "scheduled",
"dueAt": "2026-12-01T00:00:00.000Z",
"leadMs": 120000,
"platformPostId": null,
"permalink": null,
"permalinkPending": false,
"publishedAt": null,
"publishedLateMs": null,
"error": null,
"reconciliation": null,
"revision": 1
},
{
"id": "0193d2a4-6b1f-7d41-a024-6f3a4b5c7e82",
"accountId": "0193c8e1-77a2-7b06-9e25-7b6c5d4e3f21",
"platform": "instagram",
"status": "scheduled",
"dueAt": "2026-12-01T00:00:00.000Z",
"leadMs": 120000,
"platformPostId": null,
"permalink": null,
"permalinkPending": false,
"publishedAt": null,
"publishedLateMs": null,
"error": null,
"reconciliation": null,
"revision": 1
}
],
"warnings": [],
"createdAt": "2026-11-30T23:51:20.000Z"
}
}Questions
- Do my customers need an account with us?
- No. They sign in on the hosted connect page, without a Dashboard login. A link stops working when it expires or when you revoke it.
- Can I keep each customer's accounts apart?
- Yes. Create one brand per customer, put the link in that brand, and restrict a key to the brand when you need to.
- Which accounts can connect?
- Instagram Business and Creator accounts. See [Connect Instagram](/docs/connect-instagram).