This API is used to issue cart promotion to customers. Enter a customerId and promotionId of the Cart Promotion to issue the promotion to the Customer.

👍
Note
For detailed information about the APIs and for hands-on testing, refer to the API overview documentation and step-by-step guide on making your first API call.

Example request

curl --location 'https://eu.api.capillarytech.com/api_gateway/v1/promotions/69117663b1cfc114606fd7fb/issueBulk?contextId=68fb1c9731d91c625a8d9e80' \
--header 'Content-Type: application/json' \6NzYzNDkxOGFmNDI3MGQ3YzI4ZjU4ZjY3MmNhZjY1ZmY=' \
--header 'Cookie: _cfuvid=IBM60ka7X5Aybk9Gp8JKVHig14rVuwA5XcyAUA-1747041228297-0.0.1.1-604800000; _cfuvid=fVY1aFlJcxMfPAsl7lBGJQG55iNNKmYw08.WciBy9eY-1747126931365-0.0.1.1-604800000; _cfuvid=.SKkqn5X9vb1GQsCWsMQPXos7ah5dTOcOGwZsXgVL14-1762781673638-0.0.1.1-604800000' \
--data '[
  566881933
]'

curl --location 'https://eu.api.capillarytech.com/api_gateway/v1/promotions/69117663b1cfc114606fd7fb/issueBulk?contextId=68fb1c9731d91c625a8d9e80' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Z2VvcmdlLmJ1a2OGFmNDI3MGQ3YzI4ZjU4ZjY3MmNhZjY1ZmY=' \
--header 'Cookie: _cfuvid=IBM60ka7X5Ayb_p8JKVHig14rVuwA5XcyAUA-1747041228297-0.0.1.1-604800000; _cfuvid=fVY1aFlJcxMfPAsl7lBGJQG55iNNKmYw08.WciBy9eY-1747126931365-0.0.1.1-604800000; _cfuvid=45d7g9Neek04LsBJTGQFH8PZDfBL6q07KlMwvdtpVcQ-1762781521742-0.0.1.1-604800000' \
--data '[
  566881933, 566135941
]'

Prerequisites

Authentication - Basic or OAuth authentication
Access group resource - Write access to customer group resource
Cart promotionId and customerId

Resource Information

URI	promotions/{promotionId}/issueBulk
Rate Limit	NA
Batch support	Yes

Path Parameter

Parameter (Parameters marked as * are required)	Data Type	Description
promotionId*	String	ID of cart promotion that is generated when creating a cart promotion. Use the get promotions for a customer API to get the promotionId for the Cart Promotion.

Query Parameter

Parameter (Parameters marked as * are required)	Data Type	Description
contextId*	String	Unique identifier of the issued promotion. It is used to identify the particular promotion.

Request Body

[
  564332013
]

Request Body Parameters

Parameter Name	Data Type	Description
customerId	Long	Unique identifier of the customer.

Response Body

{
    "data": {
        "564332013": {
            "id": "68230a3af1ebc84977d9ea2c",
            "customerId": 564332013,
            "promotionId": "67f3832ab206f929966adf81",
            "earnedFromId": "2 items in cart",
            "eventTime": 1747126842954,
            "validTill": 1748716199999
        }
    }
}

Response Body Parameters

Parameter	Data Type	Description
data	Object	Object containing details of the customer and issued cart promotion.
-- id	String	The unique identifier for the issued promotion.
-- customerId	Long	The ID of the customer to whom the promotion was issued.
-- promotionId	String	The ID of the promotion that was issued.
-- earnedFromId	String	The context ID that was passed in the API request, used to track the source of the issuance.
-- eventTime	Long	The timestamp (in milliseconds) when the promotion was issued.
-- validTill	Long	The timestamp (in milliseconds) until which the issued promotion is valid.

API Error Code

Code	Description
404	Passed promotion is not found