POST /api/api/v2/webhooks/posts
Create a post via incoming webhook (v2)

Errors

Code Description
401 Unauthorized (missing or invalid secret)
422 Validation errors
503 Receiving disabled by admin settings

Examples

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" }

Params

Param name Description
title
required

Post title

Validations:

  • Must be a String
content
optional

Post content (text or HTML)

Validations:

  • Must be a String
post_type
optional

Type of the post (e.g., idea, problem, note)

Validations:

  • Must be a String
user_id
required

User ID for the post creator

Validations:

  • Must be a Integer
subject_id
optional

Optional subject ID

Validations:

  • Must be a Integer
problem_id
optional

Optional problem ID

Validations:

  • Must be a Integer
lat
optional

Latitude

Validations:

  • Must be a Float
long
optional

Longitude

Validations:

  • Must be a Float
posted_to_id
optional

Destination/posted_to ID

Validations:

  • Must be a Integer
geo_maxing
optional

Geo-maxing flag

Validations:

  • Must be one of: TrueClass, FalseClass.
group_id
optional

Group ID

Validations:

  • Must be a Integer
tags
optional

List of tags

Validations:

  • Must be an array of String
resource_tags
optional

List of resource tags

Validations:

  • Must be an array of String
created_at
optional

ISO8601 timestamp to override creation time

Validations:

  • Must be a String
updated_at
optional

ISO8601 timestamp to override updated time

Validations:

  • Must be a String

Headers

Header name Description
X-Webhook-Secret
required 		Shared secret for authentication