Surveys

Create Survey Campaign

Create a new survey campaign. The campaign is created in a stopped state (is_live: false). Use the Toggle Campaign Live endpoint to start it.

POST/nfthing/survey/create

Headers

Field	Type	Required	Description
X-API-Key	string	Yes	Your Membrane API key.
Content-Type	string	Yes	Must be application/json.

Request body

Field	Type	Required	Description
title	string	Yes	Survey title.
description	string	Yes	Survey description.
content_url	string	No	URL associated with the survey.
category	string	Yes	Survey category (e.g. "technology").
tagline	string	Yes	Short tagline for the survey.
reward_amount	integer	Yes	Reward amount for completing the survey.

Example request

POST /nfthing/survey/create

{
  "title": "Tech Survey 2026",
  "description": "Share your thoughts on the latest tech trends",
  "content_url": "https://example.com/tech-survey",
  "category": "technology",
  "tagline": "Your opinion matters",
  "reward_amount": 15
}

Example response

200 OK

{
  "success": true,
  "message": "Survey campaign created successfully",
  "data": {
    "id": 84,
    "post_id": "bbfea083-da7f-492f-a29d-9f66848de9e4",
    "type": "survey",
    "title": "Tech Survey 2026",
    "is_live": false
  }
}

Notes

• Save the post_id from the response — you'll need it to add questions and toggle the campaign live.