We hope you enjoy our updated documentation! The old documentation website is still available here. Reach out to us with feedback or questions. Happy programming! 🎉

Create exclusion group

POST

/surveygroups

Last modified:2025-08-10 21:31:19

Description

Surveys 400689 and 400690 are related, and a respondent who participated in one survey cannot participate in any of the other survey.

The value you assign to buyer_surveygroup_ref must be globally unique within our system. Consider adding "-[YOUR COMPANY NAME]" to the end of your desired value to ensure this.

You can't group a survey that had been created with incl_excl=1 (a recontact survey).

Request

Header Params

Body Params application/json

Example

{
    "buyer_surveygroup_ref": "ExclPr",
    "name": "Cosmetics Project",
    "surveys_in_group": [
        400689,
        400690
    ],
    "exclusion_period": 120
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://staging.spectrumsurveys.com/buyers/v2/surveygroups' \
--header 'access-token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "buyer_surveygroup_ref": "ExclPr",
    "name": "Cosmetics Project",
    "surveys_in_group": [
        400689,
        400690
    ],
    "exclusion_period": 120
}'

Responses

🟢201Created

application/json

Body

Example

{
    "buyer_surveygroup_ref": "ExclPr",
    "name": "Cosmetics Project",
    "surveys_in_group": [
        400689,
        400690
    ],
    "exclusion_period": 120
}

🟠400Bad Request

Modified at 2025-08-10 21:31:19

Survey group exclusions

Update exclusion group

Create exclusion group

Description#

Request

Request Code Samples

Responses

Description