---
title: "Post a list of offline behavioral actions"
method: POST
path: "/v1/offline_behavioral_actions"
tags: ["Behavioral actions"]
---

# Post a list of offline behavioral actions

`POST /v1/offline_behavioral_actions`

## Request

- Base URL: `https://ac.cnstrc.com`
- URL: `https://ac.cnstrc.com/v1/offline_behavioral_actions`
- Auth: HTTP basic

**🔐 This endpoint requires [HTTP Basic authentication](https://docs.constructor.com/reference/main-authentication#basic-authentication).**

Send list of behavioral actions (purchase,return) performed by your users offline.

## Query parameters

- `key` string, required: The key of the index to use.
- `section` string: The section of the index to use. Defaults to `Products`.

## Request body

- OfflineBehavioralActionListPostBody
  - `behavioral_actions` union[], required: An array of actions. Each item of the array is an object containing action and data keys.
    - union
      - OfflinePurchase
        - `action` 'purchase', required: Event action.
        - `data` OfflineItemPurchaseSchema, required
          - `_dt` integer, required: Unix timestamp in seconds of when the event happened
          - `ui` string: Identifier that maps to an internal user account ID on a customer website.
          - `order_id` string: Order id. Can be used to merge different events into single one.
          - `lat` string: Latitude of store.
          - `lon` string: Longitude of store.
          - `store_id` string: Store id.
          - `items` ItemSchema[], required: Array of items.
            - `item_id` string: Id of purchased item. Either item_id or item_name is required to be passed.
            - `item_name` string: Name of purchased item. Either item_id or item_name is required to be passed.
            - `variation_id` string: Id of purchased variation, if applicable. Either item_id or item_name of related item must be passed along with variation_id.
            - `price` union: Price of purchased item or variation. Will be used to calculate purchase revenue if order revenue is not passed. Passed as string, from which numeric value will be extracted.
              - …
            - `count` integer: Count of item purchased. Price will be multiplied by count to get purchase revenue if order revenue is not passed.
          - `revenue` union: Revenue of order. Can be passed explicitly or will be evaluated by summation of passed item prices and its counts.
            - number
            - integer
      - OfflineReturn
        - `action` 'return', required: Event action.
        - `data` OfflineItemReturnSchema, required
          - `_dt` integer, required: Unix timestamp in seconds of when the event happened
          - `ui` string: Identifier that maps to an internal user account ID on a customer website.
          - `order_id` string: Order id. Can be used to merge different events into single one.
          - `items_returned` ItemSchema[], required: Array of items that were returned.
            - `item_id` string: Id of purchased item. Either item_id or item_name is required to be passed.
            - `item_name` string: Name of purchased item. Either item_id or item_name is required to be passed.
            - `variation_id` string: Id of purchased variation, if applicable. Either item_id or item_name of related item must be passed along with variation_id.
            - `price` union: Price of purchased item or variation. Will be used to calculate purchase revenue if order revenue is not passed. Passed as string, from which numeric value will be extracted.
              - …
            - `count` integer: Count of item purchased. Price will be multiplied by count to get purchase revenue if order revenue is not passed.
          - `items_kept` ItemSchema[]: Array of items from one order that were kept.
            - `item_id` string: Id of purchased item. Either item_id or item_name is required to be passed.
            - `item_name` string: Name of purchased item. Either item_id or item_name is required to be passed.
            - `variation_id` string: Id of purchased variation, if applicable. Either item_id or item_name of related item must be passed along with variation_id.
            - `price` union: Price of purchased item or variation. Will be used to calculate purchase revenue if order revenue is not passed. Passed as string, from which numeric value will be extracted.
              - …
            - `count` integer: Count of item purchased. Price will be multiplied by count to get purchase revenue if order revenue is not passed.
          - `items_cross_sold` ItemSchema[]: Array of items that were sold to user instead of returned items
            - `item_id` string: Id of purchased item. Either item_id or item_name is required to be passed.
            - `item_name` string: Name of purchased item. Either item_id or item_name is required to be passed.
            - `variation_id` string: Id of purchased variation, if applicable. Either item_id or item_name of related item must be passed along with variation_id.
            - `price` union: Price of purchased item or variation. Will be used to calculate purchase revenue if order revenue is not passed. Passed as string, from which numeric value will be extracted.
              - …
            - `count` integer: Count of item purchased. Price will be multiplied by count to get purchase revenue if order revenue is not passed.
          - `revenue` union: Revenue of order. Can be passed explicitly or will be evaluated by summation of passed item prices and its counts.
            - number
            - integer
          - `return_expenses` union: Return expenses of order. Can be passed explicitly or will be evaluated by summation of passed refund and return_shipping_cost
            - number
            - integer
          - `refund` union: Refund. Can be passed explicitly or will be evaluated by summation of passed item prices and cost
            - number
            - integer
          - `return_shipping_cost` union: The cost associated with the return shipping, if applicable
            - number
            - integer
          - `return_reason` string: The reason provided by the customer for the return (e.g., damaged item, wrong size, changed mind, etc.).
          - `return_type` 'full' | 'partial'
          - `return_preference` 'refund' | 'replacement'
          - `lat` string: Latitude of drop off place.
          - `lon` string: Longitude of drop off place.
          - `return_drop_off` string: The designated point or place where the return was made. It can encompass various options, including post offices, physical stores, or other specific locations.

## Response `204`

No Content

## Other responses

- `400`: Validation Error
- `401`: Credentials are not passed or action is forbidden
- `429`: Rate limit breached

---

[API](https://skmtc.dev/constructor/apis/behavioral-actions.md) - [All operations](https://skmtc.dev/constructor/apis/behavioral-actions/llms.txt) - [OpenAPI document](https://skmtc.dev/constructor/apis/behavioral-actions/revisions/48df4043ed7a?raw)