---
title: "Create Event"
method: POST
path: "/api/v1/events"
tags: ["events"]
---

# Create Event

`POST /api/v1/events`

## Request

- Base URL: `https://api.intentlink.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.intentlink.io/api/v1/events`
- Auth: HTTP bearer

## Request body

- EventCreate
  - `event_type` 'recommendation_shown' | 'recommendation_clicked' | 'coupon_copied' | 'link_resolve_failed' | 'conversion_synced', required
  - `url` string, uri, nullable: The URL the end user clicked.
  - `click_id` string, nullable
  - `request_id` string, nullable
  - `result_id` string, nullable
  - `attribution_id` string, nullable
  - `affiliate_link_id` string, nullable
  - `agent_id` string, nullable
  - `developer_id` string, nullable
  - `developer_account_id` string, nullable
  - `channel` string, nullable
  - `agent_session_id_hash` string, nullable
  - `end_user_id_hash` string, nullable
  - `properties` object
  - `occurred_at` string, date-time, nullable

## Response `200`

Successful Response

- EventAcceptedResponse
  - `event_id` string, required
  - `accepted` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/intentlink/apis/affiliate-recommendation-service.md) · [All operations](https://skmtc.dev/intentlink/apis/affiliate-recommendation-service/llms.txt) · [OpenAPI document](https://skmtc.dev/intentlink/apis/affiliate-recommendation-service/revisions/95cc11d55fb6?raw)