Skip to content
Relay Port

Solutions

Publish from your automations with an HTTP step.

Call the API from n8n, Make or Zapier with a plain HTTP step. Dedicated nodes are planned.

Build with

Tools and their nodes
ToolNodeUse today
n8nPlannedUse the HTTP request step.
MakePlannedUse the HTTP module.
ZapierPlannedUse Webhooks by Zapier.

A workflow

How it goes, step by step.

  1. 01Add an HTTP request step that calls POST /posts with your API key.
  2. 02Send the automation's run id as the Idempotency-Key, so a step that runs again returns the same post.
  3. 03Create a webhook endpoint for post.target.published, post.target.failed and post.target.unconfirmed.
  4. 04Start a second automation from the webhook, after verifying its signature.
  5. 05Notify your team when a target fails or is unconfirmed.

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

Is there an n8n, Make or Zapier node?
Not yet. Nodes for n8n, Make and Zapier are planned, not shipped. Until then, use their HTTP request steps with the API.
Why send an Idempotency-Key from an automation?
Automation tools retry steps when something goes wrong. With the same key on every attempt, a retry returns the same post.