User.com REST API Docs

# Create product event (alternative)

There's an alternative endpoint for creating a product event assigned to a specific user.
If your products have custom IDs with "/" character, the standard endpoint will not work and you need to use the endpoint given below:

POST /product-event-creation/:custom_id/

Attributes Type Required Description
user_id integer yes A unique identifier for the user which is given by User.com automatically.
user_custom_id string yes The unique identifier for the user which is provided by the client.
custom_id string no A unique identifier for the product provided by the client.
data json yes A valid JSON object with additional data (attributes). Special "custom_data" key may contain additional custom json defined data unique per product event occurence.
event_type string yes A prefined event type. Find defined choices: https://docs.user.com/how-to-create-product-events/
timestamp timestamp yes A datetime when an event occured in UNIX format.

# Request

  • CURL
  • JavaScript
  • PHP
  • Python 
curl -X POST
    "https://<your_app_subdomain>.user.com/api/public/product-event-creation/:custom_id/"
    -H 'authorization: Token <your_64_char_api_key>'
    -H 'content-type: application/json'
    -d '{
    "user_id": 431,  // OR use user_custom_id
    "event_type": "order",
    "timestamp": 1426967129,
    "data": {
      "create attribute for product": "my value",
      "custom_data": {
        "custom attr": "json data"
      }
    }
  }'

# Response

{
  "id": 388
}

← Delete product →