1. User Management
  • Getting Started
  • Locations
    • Location Attributes
      MARKDOWN
    • Photo specifications for your business location
      MARKDOWN
    • Star and Unstar Photos
      MARKDOWN
    • Create a new business location
      POST
    • Update business location
      POST
    • List all locations
      GET
    • List particular locations
      GET
    • Search locations
      GET
    • Get locations by store codes
      GET
    • Upload Photos to a Location
      POST
    • Check Bulk Photo Upload Status
      GET
    • Star/Unstar Location Photos
      POST
    • Delete Location Photos
      POST
    • Archive multiple locations
      POST
    • Cancel scheduled location archival
      POST
    • Activate archived locations
      POST
    • List Active Subscriptions
      GET
    • Get a list of supported countries and their states
      GET
    • Get SubCategories and AdditionalCategories
      GET
    • Get Site Details for Your Plan
      GET
  • Organizing locations
    • Organizing locations
    • Create a new folder
    • List all folders
    • List all folders under an account in hierarchical structure
    • Get details of a folder
    • Rename a folder
    • Add locations to a folder
    • Remove locations from a folder
    • Delete a folder
    • List locations under a folder
    • List all tags
    • List locations by tags
    • Add location to a tag
    • Remove location from a tag
  • User Management
    • User Attributes
      MARKDOWN
    • Create User with Role
      POST
    • List Users
      GET
    • List Users by ID
      GET
    • Add Locations to User
      POST
    • Add User and folder
      POST
    • List User Roles
      GET
    • Add folders to user
      POST
    • List User Resources
      GET
    • Update a User
      POST
    • Remove Folders for User
      POST
    • Remove Locations for User
      POST
  • Grid Rank
    • Local Rank Grid
    • Create Rank Grid Report
    • Fetch All Grid Reports for Location
    • Fetch Rank Grid Report By ID
  • Review Campaigns
    • Review Campaign Info Attributes
    • Create a review campaign
    • Add customers to a review campaign
    • List review campaigns
    • List review campaign customers
  • Listings
    • Listings
    • Listing Status Webhooks
    • Get premium listings
    • Get voice listings for a location
    • Get duplicate listings for a location
    • Get all duplicate listings for an account
    • Mark listings as duplicates
    • Mark listings as not duplicates
    • Get AI listings
  • Connected Accounts
    • Connected Accounts
    • Connect Google Profile to Account
    • Connect Facebook Page to Account
    • List all connected accounts
    • List folders under a Google account
    • Create GMB Listing
    • Disconnect GMB Profile
    • Disconnect Facebook Account
    • Fetch Connected Account Details
    • Trigger New Matches
    • List Connection Suggestions
    • Fetch Connected Account Listings
    • Confirm Connected Account Matches
    • Connect a location with a listing of a connected account
    • Disconnect Location from Listing
  • Rankings
    • Rankings Analytics Attributes
    • Add keywords
    • List Keywords
    • Get keywords performance
    • Archive a keyword
    • Get Rollup Keyword Performance
    • Get Rankings Distribution By Time
  • Profile Analytics
    • Profile Analytics
    • Get Bing Analytics
    • Get Facebook Page Analytics
    • Get Google My Business Analytics
  • Reviews
    • Reviews
    • Review Sources
      • Get a list of interaction sources for location
      • Get a list of interaction sources for account
      • Add / Edit interaction source
    • Fetch all interactions
    • List Interactions by IDs
    • Respond to an Interaction
    • Edit Response for Interaction
    • Archive Response for Interaction
    • Get Interaction Analytics
    • Add Review Widget
    • Edit Review Widget
  • Automations
    • Temporary Close Location with a reopening date
  • Error Codes
    • ERROR CODES
  1. User Management

Add User and folder

POST
https://api.synup.com/api/v4/users/add_user_and_folder
This api is a combination of add_user and create_folder and assign_folder_to_user APIs. The API will take in all parameters of add_user API and create_folder APIs. Operations to be done are create user, create folder and assign folder to user.

Request

Header Params

Body Params application/json

Example
{
    "input": {
        "roleId": "Q3VzdG9tUm9sZToyMDgzMQ==",
        "firstName": "testing ",
        "lastName": "user",
        "email": "sandeep.kota+918673997@synup.com",
        "directCustomer": true,
        "locale": "ENGLISH",
        "locationIds": [
            "TG9jYXRpb246ODcxMjE="
        ],
        "socialProfileIds": [],
        "name": "sandybroskis19"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.synup.com/api/v4/users/add_user_and_folder' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "input": {
        "roleId": "Q3VzdG9tUm9sZToyMDgzMQ==",
        "firstName": "testing ",
        "lastName": "user",
        "email": "sandeep.kota+918673997@synup.com",
        "directCustomer": true,
        "locale": "ENGLISH",
        "locationIds": [
            "TG9jYXRpb246ODcxMjE="
        ],
        "socialProfileIds": [],
        "name": "sandybroskis19"
    }
}'

Responses

🟢200OK
application/json
Successfully added folders to user
Body

Example
{
    "data": {
        "addUserAndFolder": {
            "success": true,
            "assignFolder": true,
            "user": {
                "firstName": "testing",
                "lastName": "user",
                "email": "sandeep.kota+919673997@synup.com",
                "directCustomer": true,
                "databaseId": 15066
            },
            "folder": {
                "id": "aa9df7a4-5a45-41d2-91b5-929d63033dcc",
                "name": "sandybroskis20",
                "locationCount": null
            },
            "errors": []
        }
    }
}
Modified at 2025-07-21 09:53:13
Previous
Add Locations to User
Next
List User Roles
Built with