---
title: "Adds a Structured Custom Event"
method: POST
path: "/MarketingCustomEvent"
tags: ["MarketingCustomEvents"]
---

# Adds a Structured Custom Event

`POST /MarketingCustomEvent`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/MarketingCustomEvent`
- Auth: none declared. Required headers: `Authorization`

PROSPECT_ID, CATEGORY, and ACTION are all required when creating an event. These are used to properly categorize and score the event.

## Headers

- `Authorization` string, required

## Request body

- APIMarketingActivity
  - `PROSPECT_ID` integer, required
  - `CATEGORY` string, required
  - `ACTION` string, required
  - `LABEL` string
  - `PROPERTY` string
  - `VALUE` string
  - `IPADDRESS` string

## Response `201`

Event added.

- object
  - `PROSPECT_ID` integer, required
  - `CATEGORY` string, required
  - `ACTION` string, required
  - `LABEL` string
  - `PROPERTY` string
  - `VALUE` string
  - `IPADDRESS` string

## Other responses

- `400`: Data validation error.
- `401`: Invalid api key provided.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)