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.
The API is plain HTTP and JSON, so any automation tool that can call a URL can use it today. Dedicated nodes are planned, not shipped: the table below names the step to use until then.
See webhooks for the signed deliveries a second automation can start from.
Build with
| Tool | Node | Use today |
|---|---|---|
| n8n | Planned | Use the HTTP request step. |
| Make | Planned | Use the HTTP module. |
| Zapier | Planned | Use Webhooks by Zapier. |
A workflow
How it goes, step by step.
- 01Add an HTTP request step that calls POST /posts with your API key.
- 02Send the automation's run id as the Idempotency-Key, so a step that runs again returns the same post.
- 03Create a webhook endpoint for post.target.published, post.target.failed and post.target.unconfirmed.
- 04Start a second automation from the webhook, after verifying its signature.
- 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" }
]
}'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
- 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.