Create Survey

curl --request POST \
  --url https://demand.researchdesk.com/surveys \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "name": "<string>",
  "country": "<string>",
  "language": "<string>",
  "completes_wanted": 123,
  "incidence_rate": 123,
  "length_of_interview": 123,
  "status": "<string>"
}
'

import requests

url = "https://demand.researchdesk.com/surveys"

payload = {
    "project_id": "<string>",
    "name": "<string>",
    "country": "<string>",
    "language": "<string>",
    "completes_wanted": 123,
    "incidence_rate": 123,
    "length_of_interview": 123,
    "status": "<string>"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    project_id: '<string>',
    name: '<string>',
    country: '<string>',
    language: '<string>',
    completes_wanted: 123,
    incidence_rate: 123,
    length_of_interview: 123,
    status: '<string>'
  })
};

fetch('https://demand.researchdesk.com/surveys', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://demand.researchdesk.com/surveys",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'project_id' => '<string>',
    'name' => '<string>',
    'country' => '<string>',
    'language' => '<string>',
    'completes_wanted' => 123,
    'incidence_rate' => 123,
    'length_of_interview' => 123,
    'status' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://demand.researchdesk.com/surveys"

	payload := strings.NewReader("{\n  \"project_id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"country\": \"<string>\",\n  \"language\": \"<string>\",\n  \"completes_wanted\": 123,\n  \"incidence_rate\": 123,\n  \"length_of_interview\": 123,\n  \"status\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://demand.researchdesk.com/surveys")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"project_id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"country\": \"<string>\",\n  \"language\": \"<string>\",\n  \"completes_wanted\": 123,\n  \"incidence_rate\": 123,\n  \"length_of_interview\": 123,\n  \"status\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://demand.researchdesk.com/surveys")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"project_id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"country\": \"<string>\",\n  \"language\": \"<string>\",\n  \"completes_wanted\": 123,\n  \"incidence_rate\": 123,\n  \"length_of_interview\": 123,\n  \"status\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "survey": {
    "id": "a038a197-c849-47c8-9c6d-9fe7b497601f",
    "project_id": "78f7fc48-3e66-4b10-ae8f-e6566aa62642",
    "name": "5G Network Adoption and Purchasing Decisions",
    "status": "Draft",
    "survey_attributes": {
      "respondents": 2000,
      "country_code": "US",
      "language_code": "EN",
      "length_of_interview": 5,
      "incidence_rate": 90,
      "minimum_price_per_complete": 1.55,
      "offered_price_per_complete": 1.55,
      "device_compatibilities": [
        "Desktop"
      ],
      "collects_pii": false,
      "hashing_enabled": false,
      "calculation_type": "Completes",
      "traffic_control_limit_type": "None",
      "out_of_field_date": "2026-05-20 06:00:00",
      "out_of_field_timezone": "(UTC-06:00) Easter Island",
      "entry_link": "https://repdata.decipherinc.com/survey/selfserve/53b/220106?list=2&rid=[%RDUD%]",
      "redirects": {
        "complete": "https://www-staging.rdsecured.com/return?inbound_code=1000&rdud=[%RDUD%]",
        "standard_termination": "https://www-staging.rdsecured.com/return?inbound_code=2000&rdud=[%RDUD%]",
        "quality_termination": "https://www-staging.rdsecured.com/return?inbound_code=1&rdud=[%RDUD%]",
        "security_termination": "https://www-staging.rdsecured.com/return?inbound_code=3000&rdud=[%RDUD%]",
        "overquota_termination_term": "https://www-staging.rdsecured.com/return?inbound_code=4000&rdud=[%RDUD%]"
      }
    },
    "respondent_attributes": [
      {
        "quota_id": "6a3d7e84-52d2-49fe-adda-a9d53134922b",
        "quota_name": "Nested Age 33-35 Domestic Air Travelers",
        "quota": 100,
        "survey_starts": 0,
        "survey_completes": 0,
        "qualifications": [
          {
            "question_id": 2,
            "allowed_option_ids": [
              1
            ]
          },
          {
            "question_id": 1,
            "allowed_option_ids": [
              "33",
              "34",
              "35"
            ]
          }
        ]
      },
      {
        "quota_id": "8f0cb8ab-c87b-4fd1-9b02-9c61f0c8a26d",
        "quota_name": "30-32",
        "quota": 100,
        "survey_starts": 0,
        "survey_completes": 0,
        "qualifications": [
          {
            "question_id": 1,
            "allowed_option_ids": [
              "30",
              "31",
              "32"
            ]
          }
        ]
      }
    ]
  }
}