Create an Event

Create new event

post

Create a new event for a contact. To identify the contact, use either user_id, or email & firstname or phone & firstname

Header parameters

X-API-KEYstringrequired

Your API key

X-SECRET-KEYstringrequired

Your Secret key

Body

app_idstringrequired

_idstringoptional

user_idstringrequired

emailstringoptional

phonestringoptional

event_typestringrequired

event_namestringoptional

event_datestring · daterequired

Date of the event in YYYY-MM-DD format

event_timestring · timeoptional

Time of the event in HH:MM AM/PM format

idstringrequired

Unique Event ID from your system

is_visitbooleanoptional

is_purchasebooleanoptional

event_dataobject[]optional

Event data with custom fields such as status, staff etc.

Example: {"status":"completed","staff":"John Doe"}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.gleantap.com/v2/ExternalApi/newEvent' \
  --header 'X-API-KEY: text' \
  --header 'X-SECRET-KEY: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "app_id": "text",
    "_id": "text",
    "user_id": "text",
    "email": "text",
    "phone": "text",
    "event_type": "text",
    "event_name": "text",
    "event_date": "2025-04-02",
    "event_time": "15:26:32",
    "id": "text",
    "is_visit": true,
    "is_purchase": true,
    "event_data": {
      "status": "completed",
      "staff": "John Doe"
    }
  }'

200

400

200

{
  "result": "success"
}

Event created successfully