--- updatedAt: 2026-03-30T09:23:33.000Z agentTools: projectIndex: https://developers.bazaarvoice.com/v1.0-TransactionsAPI/llms.txt --- # Create Bulk Transactions It creates transactions' records into the system.Bazaarvoice using this input will schedule Review Requests Notifications. > 📘 Try out Bulk Transaction API reference [here.](/v1.0-TransactionsAPI/reference/ingestbulktransaction) ## Request The Bulk Transactions API facilitates the submission of multiple transaction records in a single request to Bazaarvoice. Each batch of transactions is identified by a unique batch Id, allowing for easier tracking and management. Additionally, the API now includes a status field to indicate the current processing status of each batch. > 📘 HTTP POST is required. ``` POST https://[stg].api.bazaarvoice.com/customer-transactions/bulk-transactions HTTP/1.1 Content-Type: application/json Authorization: Bearer {ACCESS_TOKEN} ... { "clientName": "client-1", "transactions": [ { "id": "transactionId-1234", "products": [ { "id": "apple-iphone-14-pro", "name": "Apple Iphone 14 pro", "money": { "amount": 1099, "currency": "EUR" }, "imageUrl": "https://test-client.com/eu/images/apple-iphone-14-pro-1", "incentivizedReview": "true" } ], "emailAddress": "end-customer-emailid@gmail.com", "transactionDate": "2023-06-06T08:47:51.792Z", "nickname": "John Doe", "userId": "john_doe_1", "locale": "en_US", "deploymentZone": "main_site" }, { "id": "transactionId-5678", "products": [ { "id": "test-product-id", "name": "test product", "money": { "amount": 1999, "currency": "EUR" }, "imageUrl": "https://test-client.com/eu/images/test-product-id", "incentivizedReview": "coupon" } ], "emailAddress": "sarah.lee@gmail.com", "transactionDate": "2023-06-06T08:47:51.792Z", "nickname": "Sarah Lee", "userId": "sarah_lee", "locale": "en_US", "deploymentZone": "main_site" } ] } ``` Ellipses (…) in above example indicate that your application may generate other headers. ### > 📘 Older applications may be using `https://[stg.]api.bazaarvoice.com/**contentmanagement**` as the base URL for the Response API, instead of `https://[stg.]api.bazaarvoice.com/**response**`.The `contentmanagement` URL has been deprecated. However, Bazaarvoice will continue to support applications that use the `contentmanagement` URL until further notice. ### Parameters [block:parameters] { "data": { "h-0": "Name", "h-1": "Description", "h-2": "Required", "0-0": "**Header**", "0-1": "", "0-2": "", "1-0": "`Content-Type`", "1-1": "application/json.", "1-2": "Yes", "2-0": "`Authorization`", "2-1": "The Authorization value will consist of the string `Bearer` followed by the OAuth2 access token. Refer to [OAuth2 Integration](https://bazaarvoice-developer-center.readme.io/v1.0-TransactionsAPI/reference/post_auth-v1-oauth2-token) for more information.", "2-2": "Yes", "3-0": "**Body**", "3-1": "", "3-2": "", "4-0": "`clientName`", "4-1": "Unique identifier of the client.", "4-2": "Yes", "5-0": "`id`", "5-1": "The Identifier for the transaction between the end customer and the client. The client provides this and Bazaarvoice does not create it.", "5-2": "Yes", "6-0": "`products`", "6-1": "This is an array of product details that are part of the transaction. For example, in a transaction, if a customer purchases 2 products this array will be populated with both the product details", "6-2": "Yes", "7-0": "`products.id`", "7-1": "The product identifier internal to the client.", "7-2": "Yes", "8-0": "`products.name`", "8-1": "The name of the product.", "8-2": "Yes", "9-0": "`products.money`", "9-1": "An object representing the monetary value, including the amount and currency of the transaction", "9-2": "Yes", "10-0": "`products.money.currency`", "10-1": "This is a 3-letter currency code as defined by ISO-4217. Eg. EUR", "10-2": "No", "11-0": "`products.money.amount`", "11-1": "The price of the product.", "11-2": "No", "12-0": "`products.imageUrl`", "12-1": "The URL of the image to be passed on and available in the notification.", "12-2": "Yes", "13-0": "`products.incentivizedReview`", "13-1": "The type of incentive received by the end customer. \nYou can specify the incentive as a descriptive value (e.g., \"Coupon\", \"Cashback\", \"Sweepstakes\") or use a boolean value (true or false) to denote whether an incentive was provided.", "13-2": "No", "14-0": "`emailAddress`", "14-1": "The email address of the end customer for whom we need to send notifications.", "14-2": "Yes", "15-0": "`transactionDate`", "15-1": "The time at which the transaction was made at the client by the end customer.", "15-2": "Yes", "16-0": "`nickname`", "16-1": "The end customer username used during notifying the end customer.", "16-2": "Yes", "17-0": "`userId`", "17-1": "The end customer userId to be provided.", "17-2": "Yes", "18-0": "`locale`", "18-1": "The locale data in bcp47 format to be provided.", "18-2": "Yes", "19-0": "`deploymentZone`", "19-1": "The deployment zone that this transaction should be processed at. E.g: main_site.", "19-2": "Yes", "20-0": "`transactionChannel`", "20-1": "The preference channel over which you would like to notify the customer. E.g.: EMAIL.", "20-2": "No" }, "cols": 3, "rows": 21, "align": [ "left", "left", "left" ] } [/block] ### Limits | Name | Description | Limit | | ------------------------- | ------------------------------------------------------------------------------------------------ | ------- | | ` Number of Transactions` | refers to the maximum allowable number of transactions that can be included in a single request. | 200 | | `Request Size` | The Request Size Limit defines the maximum allowable size for the entire request payload. | 256 KiB | ## Response ### Header HTTP status 207 indicates the submission of multiple transactions. ### Body Below is an example of a successful creation of a transaction request: ``` { "batchId": "unique_batch_id", "batchStatus": "ACCEPTED", "items":[ { "transactionId":"transactionId-1234", "occurredAt":"2024-02-20T13:54:33.338998+05:30", "status":"ACCEPTED", "message":"Accepted." }, { "transactionId":"transactionId-5678", "occurredAt":"2024-02-20T13:54:33.339009+05:30", "status":"FAILURE", "message":"An unexpected error has occurred, please retry. Contact Bazaarvoice if the problem persists." } ] } ``` ## Errors For a detailed description and solution to Response API errors, refer to [Troubleshooting](/v1.0-ResponseAPI/docs/troubleshooting). The following lists specific errors that may be encountered when creating a new client response request: ##### clientId must not be empty The required parameter `clientId` is not included in the request. ``` { "type": "/problems/bad-request", "instance": "/customer-transactions/bulk-transactions", "title": "Bad Request", "status": 400, "detail": "The required fields are missing. Ensure the Request Body has all required fields and try again." } ``` ##### The number of transactions exceeded. The number of transactions in the request must be less or equal to the max-defined limit. ``` { "type": "/problems/bad-request", "instance": "/customer-transactions/transactions", "title": "Bad Request", "status": 400, "detail": "The number of transactions in the request exceeds the maximum allowed limit. Please reduce the number of transactions and try again." } ``` ##### Request size exceeded. The size of the request must not exceed the maximum allowed limit. ``` { "type": "/problems/bad-request", "instance": "/customer-transactions/transactions", "title": "Bad Request", "status": 400, "detail": "The size of the request exceeds the maximum allowed limit. Please reduce the size of the request payload and try again." } ``` ##### Valid AccessToken must be provided. The required parameter `AccessToken` is not included in the request or expired: ``` { "type": "/problems/unauthorized", "instance": "/customer-transactions/bulk-transactions", "title": "Unauthorized", "status": 401, "detail": "Request lacks valid authentication credentials for this resource." } ``` ##### Provided client details in the header must be correct. The client details are invalid: ``` { "type": "/problems/forbidden", "instance": "/customer-transactions/bulk-transactions", "title": "Forbidden", "status": 403, "detail": "Credentials lack the permission to perform this action with this resource." } ``` ##### Something unexpected occurs. Unexpected network issue occurs: ``` { "type": "/problems/internal-error", "instance": "/customer-transactions/bulk-transactions", "title": "Internal Error", "status": 500, "detail": "An unexpected error has occurred, please retry. Contact Bazaarvoice if the problem persists." } ```