| Code | Description |
|---|---|
| 401 | Unauthorized (missing or invalid secret) |
| 422 | Validation errors |
| 503 | Receiving disabled by admin settings |
Request:
POST /api/v2/webhooks/posts
Headers: { "X-Webhook-Secret": "<secret>" }
Body:
{
"title": "Example from Webhook",
"content": "Hello from an external system",
"post_type": "idea",
"user_id": 1,
"tags": ["integration", "external"]
}
Success (201):
{ "id": 42, "url": "https://needpedia.org/posts/42" }
| Param name | Description |
|---|---|
|
title
required |
Post title Validations:
|
|
content
optional |
Post content (text or HTML) Validations:
|
|
post_type
optional |
Type of the post (e.g., idea, problem, note) Validations:
|
|
user_id
required |
User ID for the post creator Validations:
|
|
subject_id
optional |
Optional subject ID Validations:
|
|
problem_id
optional |
Optional problem ID Validations:
|
|
lat
optional |
Latitude Validations:
|
|
long
optional |
Longitude Validations:
|
|
posted_to_id
optional |
Destination/posted_to ID Validations:
|
|
geo_maxing
optional |
Geo-maxing flag Validations:
|
|
group_id
optional |
Group ID Validations:
|
|
tags
optional |
List of tags Validations:
|
|
resource_tags
optional |
List of resource tags Validations:
|
|
created_at
optional |
ISO8601 timestamp to override creation time Validations:
|
|
updated_at
optional |
ISO8601 timestamp to override updated time Validations:
|
| Header name | Description |
|---|---|
|
X-Webhook-Secret required |
Shared secret for authentication |