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 supplier blend

POST

/supplier-blends

Last modified:2025-07-20 19:22:41

Description

The Supplier Blend feature allows you to save presets for Supplier Allocation, Flexibility and Groups.

In order to avoid having to create Supplier Groups and Allocations manually for every survey, you can use Supplier Blends to quickly apply these presets by choosing them from a list.

For more information follow this guide Supplier Blends & Groups.

Request

Header Params

Body Params application/json

Example

{
    "config_name": "Test Blend",
    "is_default": false,
    "is_active": true,
    "locale": "",
    "suppliers": [
        {
            "id": "",
            "is_custom_allocation": false,
            "group_name": "Supplier Group 1",
            "allocation_percentage": "60",
            "supplier_id": [
                {
                    "id": 1,
                    "allocation": 100
                },
                {
                    "id": 2,
                    "allocation": 100
                }
            ]
        },
        {
            "group_name": "Supplier Group 1",
            "allocation_percentage": "20",
            "is_custom_allocation": false,
            "id": "3",
            "supplier_id": [
                {
                    "id": 3,
                    "allocation": 100
                }
            ]
        },
        {
            "group_name": "Supplier Group 1",
            "allocation_percentage": "20",
            "is_custom_allocation": false,
            "id": "4",
            "supplier_id": [
                {
                    "id": 4,
                    "allocation": 100
                }
            ]
        }
    ]
}

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/supplier-blends' \
--header 'access-token: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "config_name": "Test Blend",
    "is_default": false,
    "is_active": true,
    "locale": "",
    "suppliers": [
        {
            "id": "",
            "is_custom_allocation": false,
            "group_name": "Supplier Group 1",
            "allocation_percentage": "60",
            "supplier_id": [
                {
                    "id": 1,
                    "allocation": 100
                },
                {
                    "id": 2,
                    "allocation": 100
                }
            ]
        },
        {
            "group_name": "Supplier Group 1",
            "allocation_percentage": "20",
            "is_custom_allocation": false,
            "id": "3",
            "supplier_id": [
                {
                    "id": 3,
                    "allocation": 100
                }
            ]
        },
        {
            "group_name": "Supplier Group 1",
            "allocation_percentage": "20",
            "is_custom_allocation": false,
            "id": "4",
            "supplier_id": [
                {
                    "id": 4,
                    "allocation": 100
                }
            ]
        }
    ]
}'

Responses

🟢200Success

application/json

Body

Example

{
    "suppliers": [
        {
            "group_name": "Test Group",
            "id": "",
            "supplier_id": [
                {
                    "id": 1,
                    "allocation": 100
                },
                {
                    "id": 2,
                    "allocation": 100
                }
            ],
            "allocation_percentage": "60",
            "is_custom_allocation": false
        },
        {
            "group_name": "",
            "id": "3",
            "supplier_id": [
                {
                    "id": 3,
                    "allocation": 100
                }
            ],
            "allocation_percentage": "20",
            "is_custom_allocation": false
        },
        {
            "group_name": "",
            "id": "4",
            "supplier_id": [
                {
                    "id": 4,
                    "allocation": 100
                }
            ],
            "allocation_percentage": "20",
            "is_custom_allocation": false
        }
    ],
    "is_default": false,
    "is_active": true,
    "is_locked": false,
    "config_name": "Test Blend",
    "buyer_id": 4046,
    "id": "sb2b8fadab5d",
    "locale": ""
}

Modified at 2025-07-20 19:22:41

Supplier management

Update the list of suppliers for a survey

Create supplier blend

Description#

Request

Request Code Samples

Responses

Description