Add customer event

Submit a customer activity event
Written by Konstantine
Updated 10 months ago

You can associate any activity event with the customer. All events are displayed in the customer profile under User Actions section.

User actions


➡️ Request

URL https://api.helpcrunch.com/v1/events
Method POST
Headers Authorization: Bearer <your_api_key>

You should specify the event data together with the customer id in the body of your POST request. Check the example below.

{
  "name": "Button Click",
  "data": {
    "button": "Start Free Trial",
    "clicks": true
  },
  "customer": 542335
}

Read more about authorization header here.


✅ Successful Response

If your request has succeeded, you'll get a 200 OK success status code together with the following response body.

{
  "id": 542335,
  "name": "Button Click",
  "data": {
    "button": "Start Free Trial",
    "clicks": 2
  },
  "createdAt": "1603885746"
}


🛑 Error Responses

You may get one of the following error status codes and responses. More info on the errors is available here.

400 Bad Request

{
  "errors": [
    {
      "code": "invalid_request",
      "message": "Invalid request"
    },
    {
      "code": "customer",
      "message": "This value should be of type numeric."
    },
    {
      "code": "filter[0].field",
      "message": "This value should not be blank."
    }
  ]
}

401 Unauthorized

{
  "errors": [
    {
      "code": "invalid_request",
      "message": "Invalid request"
    },
    {
      "code": "unauthorized",
      "message": "Unauthorized"
    }
  ]
}

404 Not Found

{
  "errors": [
    {
      "code": "invalid_request",
      "message": "Invalid request"
    },
    {
      "code": "not_found",
      "message": "Chat not found"
    }
  ]
}

429 Too Many Requests

{
  "errors": [
    {
      "code": "invalid_request",
      "message": "Invalid request"
    },
    {
      "code": "too_many_requests",
      "message": "Too many requests"
    }
  ]
}

If you have any questions regarding the REST API, feel free to chat us any time.

👩‍💻 Happy Coding! 👨‍💻

Did this answer your question?