설정하기
- 1Settings > Webhooks를 열고 이름과 공개 https 주소를 추가하세요.
- 2적용할 채널을 고르세요. 선택하지 않으면 모든 채널에 적용됩니다.
- 3이벤트를 고르세요. 게시된 게시물, 플로우가 수집한 리드, 완료된 플로우가 있습니다.
- 4Send test event를 클릭해 이벤트 샘플을 주소로 보내세요.
Zapier, Make, n8n에서
Zapier, Make, n8n용 PostNimbo 앱이 구독을 대신 처리합니다. 트리거를 켜면 도구가 수신하는 주소로 POST /public/v1/webhooks를 호출하고, 끄면 DELETE /public/v1/webhooks/:id를 호출합니다. 직접 작성한 코드에서도 API 키로 같은 작업을 할 수 있습니다.
전송 방식
- JSON 본문이 담긴 POST 요청이며, 이벤트 이름은 헤더에 있습니다
X-PostNimbo-Event. - 게시된 게시물은 10초, 플로우 이벤트는 5초 안에 응답해야 합니다. 플로우 이벤트는 시간 초과, 429 또는 5xx 응답 후 두 번 더 시도되며, 게시된 게시물은 재시도되지 않습니다. 먼저 빠르게 응답하고 작업은 그 후에 처리하세요.
- 공개 https 주소만 허용되며, 리디렉션도 공개 주소로 이어져야 합니다.
- 모든 전송은 웹훅 설정에 표시된 시크릿으로 서명되며, 서명은 다음 헤더에 있습니다
X-PostNimbo-Timestamp,X-PostNimbo-Signature.
전송 출처 확인하기
타임스탬프, 마침표, 원본 본문을 이어 시크릿으로 HMAC-SHA256을 계산한 뒤 서명 헤더와 상수 시간 비교를 하고, 5분이 넘은 타임스탬프는 거부하세요.
const crypto = require('crypto');
// rawBody: the request body exactly as received, before JSON parsing
function fromPostNimbo(rawBody, headers, secret) {
const timestamp = headers['x-postnimbo-timestamp'];
const signature = headers['x-postnimbo-signature'] || '';
if (Math.abs(Date.now() / 1000 - Number(timestamp)) > 300) return false;
const expected =
'sha256=' +
crypto
.createHmac('sha256', secret)
.update(timestamp + '.' + rawBody)
.digest('hex');
return (
signature.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
);
}이벤트
같은 목록이 GET /public/v1/webhooks/events로도 제공되므로 도구에서 트리거와 샘플 데이터를 표시할 수 있습니다.
post.publishedA post went live on a channel. Sent once per channel, after the network accepted it, with the post in the array.
Webhooks with no channels get it for every channel; the others only for the channels they list.
[
{
"id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
"content": "<p>Our autumn menu is here.</p>",
"publishDate": "2026-10-26T09:30:00.000Z",
"releaseURL": "https://www.linkedin.com/feed/update/urn:li:share:7000000000000000000",
"state": "PUBLISHED",
"integration": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"name": "Example Bakery",
"providerIdentifier": "linkedin-page",
"picture": "https://example.com/avatar.png",
"type": "social"
}
}
]post.scheduledA post was queued to publish: scheduled (or published now), rescheduled, approved, or edited while scheduled. Sent once per channel, with the same fields as post.published. The next posts of a repeating post do not send it.
Webhooks with no channels get it for every channel; the others only for the channels they list.
[
{
"id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
"content": "<p>Our autumn menu is here.</p>",
"publishDate": "2026-10-26T09:30:00.000Z",
"releaseURL": null,
"state": "QUEUE",
"integration": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"name": "Example Bakery",
"providerIdentifier": "linkedin-page",
"picture": "https://example.com/avatar.png",
"type": "social"
}
}
]post.failedA post could not be published, or its publishing could not be confirmed, and is marked as failed. Sent once per channel, with the same fields as post.published (the reason is shown in PostNimbo).
Webhooks with no channels get it for every channel; the others only for the channels they list.
[
{
"id": "5b9c3f0e-6d0a-4a59-9b8e-2f1c7a4d2e11",
"content": "<p>Our autumn menu is here.</p>",
"publishDate": "2026-10-26T09:30:00.000Z",
"releaseURL": null,
"state": "ERROR",
"integration": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"name": "Example Bakery",
"providerIdentifier": "linkedin-page",
"picture": "https://example.com/avatar.png",
"type": "social"
}
}
]lead.capturedAn automation flow saved an email or phone number someone typed in answer to a question. Sent once per answer.
Webhooks with no channels get it for every channel's flows; the others only for the flows on the channels they list.
{
"event": "lead.captured",
"timestamp": "2026-10-26T09:30:00.000Z",
"runId": "7d3f2a10-5c4e-4f8a-9a61-0e2b3c4d5e6f",
"flow": {
"id": "2a9e7c1b-3d4f-4e5a-8b6c-7d8e9f0a1b2c",
"name": "Autumn menu giveaway"
},
"channel": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"network": "instagram",
"name": "Example Bakery"
},
"contact": {
"id": "4f5e6d7c-8b9a-4c0d-9e1f-2a3b4c5d6e7f",
"name": "Sam Taylor",
"username": "samtaylor",
"email": "sam@example.com",
"phone": "+447700900123",
"tags": [
"giveaway"
],
"fields": {
"postcode": "SW1A 1AA"
}
}
}flow.completedSomeone reached the end of an automation flow. Sent once per run, with the same fields as lead.captured (email and phone are null when not collected).
Webhooks with no channels get it for every channel's flows; the others only for the flows on the channels they list.
{
"event": "flow.completed",
"timestamp": "2026-10-26T09:31:00.000Z",
"runId": "7d3f2a10-5c4e-4f8a-9a61-0e2b3c4d5e6f",
"flow": {
"id": "2a9e7c1b-3d4f-4e5a-8b6c-7d8e9f0a1b2c",
"name": "Autumn menu giveaway"
},
"channel": {
"id": "c1d2e3f4-0000-4a00-8000-000000000001",
"network": "instagram",
"name": "Example Bakery"
},
"contact": {
"id": "4f5e6d7c-8b9a-4c0d-9e1f-2a3b4c5d6e7f",
"name": "Sam Taylor",
"username": "samtaylor",
"email": "sam@example.com",
"phone": null,
"tags": [
"giveaway"
],
"fields": {}
}
}