Add locations to a folder

POST

https://api.synup.com/api/v4/locations/folders

This API adds specified locations to a folder. If the folder does not exist, it will be created automatically.

Behavior:

If locationIds are provided, the locations will be added to the folder.

If locationIds is omitted or empty, only the folder will be created.

Request

Header Params

Body Params application/json

Example

{
    "input": {
        "name": "Acme",
        "locationIds": [
            "TG9jYXRpb246MTY4NjE=",
            "TG9jYXRpb246MTY4NjA="
        ]
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.synup.com/api/v4/locations/folders' \
--header 'Authorization: T9V35W3xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": {
        "name": "Acme",
        "locationIds": [
            "TG9jYXRpb246MTY4NjE=",
            "TG9jYXRpb246MTY4NjA="
        ]
    }
}'

Responses

🟢200OK

application/json

Successfully added locations to folder

Body

Example

{
    "data": {
        "addLocationsToFolder": {
            "errors": null,
            "folder": {
                "accountId": 10072,
                "archived": false,
                "id": "0e4cc56e-45f8-4058-a713-ead264fa9318",
                "name": "acme",
                "root": false
            }
        }
    }
}

Modified at 2025-05-26 13:02:09

Rename a folder

Remove locations from a folder