---
schema_version: "1"
id: dff279d5d46e4df95d650283ce1af35f92d91cdd42281b0ca462dc92529afa9f
title: Bulk APIs for Creating & Updating Store Associates
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/commerce-cloud/retail-cloud/guides/bulk-apis-for-creating-updating-store-associates.md
canonical_url: https://developer.salesforce.com/docs/commerce/retail-cloud/guide/bulk-apis-for-creating-updating-store-associates.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 14732ec0465b9235927a4d8ec615752536a511691aedbffc498a72e5f4b7fe21
products:
  - Point of Sale for Developers
  - Salesforce APIs
---
# Bulk APIs for Creating & Updating Store Associates

Point of Sale provides a set of bulk APIs to create, update, or upsert multiple store associates at once. The bulk endpoint supports three main operations:

- Create new or update existing associates based on storeAssociateID
- Create new associates in bulk
- Update existing associates

## Upsert Associates (Create or Update)

Use this `PUT` request to create a new associate (if the ID doesn't exist) or update the existing associate (if the ID exists).

```bash
curl --location --request PUT 'https://staging.predictspring.com/service/merchant/v1/associates/bulk' \
--header 'PredictSpring-API-Key: 5vQyY72pGz8jLwMh3k' \
--header 'PredictSpring-MerchantID: SHOPNOW20140910' \
--header 'PredictSpring-Locale: en_US' \
--header 'PredictSpring-Region: US' \
--header 'PredictSpring-Username: user@predictspring.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "associateList": [
        {
            "firstName": "Richard",
            "lastName": "Britto",
            "role": "STORE_MANAGER",
            "storeAssociateID": "9000102",
            "storeID": "1920",
            "gender": "Male",
            "hireDate": 1679081600000,
            "emailId": "rb@gmail.com",
            "storeType": "Retail",
            "active": false,
            "storeAssociatePassword": "200000Es",
            "storeAssociatePasswordPin": "1234"
        }
     ]
}'
```

## Create Associates

Use this `POST` request to create new associates. Each `storeAssociateID` must be unique and must not exist in the system yet.

```bash
curl --location 'https://staging.predictspring.com/service/merchant/v1/associates/bulk' \
--header 'PredictSpring-API-Key: 5vQyY72pGz8jLwMh3k' \
--header 'PredictSpring-MerchantID: SHOPNOW20140910' \
--header 'PredictSpring-Locale: en_US' \
--header 'PredictSpring-Region: US' \
--header 'PredictSpring-Username: user@predictspring.com' \
--header 'Content-Type: application/json' \
--data-raw '{
    "associateList": [
        {
            "firstName": "Richard",
            "lastName": "Britto",
            "role": "STORE_MANAGER",
            "storeAssociateID": "9000101",
            "storeID": "1920",
            "gender": "Male",
            "hireDate": 1679081600000,
            "emailId": "rb@gmail.com",
            "storeType": "Retail",
            "active": false,
            "storeAssociatePassword": "200000Es",
            "storeAssociatePasswordPin": "1234"
        }
     ]
}'
```

## Update Associates

Use this `PATCH` request to update existing associates. Only provide the fields you want to update.

```bash
curl --location --request PATCH 'https://staging.predictspring.com/service/merchant/v1/associates/bulk' \
--header 'PredictSpring-API-Key: 5vQyY72pGz8jLwMh3k' \
--header 'PredictSpring-MerchantID: SHOPNOW20140910' \
--header 'PredictSpring-Locale: en_US' \
--header 'PredictSpring-Region: US' \
--header 'PredictSpring-Username: user@predictspring.com' \
--header 'Content-Type: application/json' \
--data '{
    "associateList": [
        {
            "storeAssociateID": "2025",
            "storeAssociatePassword": "2026"
        }
    ]
}'
```