Skip to content
Relay Port

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.

A workflow

How it goes, step by step.

  1. 01Your backend creates a connect link for the customer's brand and sends the customer to it.
  2. 02The customer logs in with Instagram on a hosted page. Meta shows its own consent screen, and you never handle the customer's credentials.
  3. 03The customer returns to your redirectUri with status, accountIds, brandId and your state.
  4. 04Your backend publishes for the connected account with POST /posts and its own API key.
  5. 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" }
    ]
  }'

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).