---
title: "Adds an Event"
method: POST
path: "/Events"
tags: ["Events"]
---

# Adds an Event

`POST /Events`

## Request

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

If you have trouble with creating an Event, try creating Events via the web interface, and then access those Events via the API. This way you            can see examples of the fields and sub-elements attached to the Event. A common source of problems during write/update request is caused when users omit            required fields, or insert invalid data in a field (e.g. reference a CATEGORY_ID that does not exist in the user's Insightly instance.

## Headers

- `Authorization` string, required

## Request body

- object
  - `EVENT_ID` integer
  - `TITLE` string, string
  - `LOCATION` string, string
  - `START_DATE_UTC` string, date-time, required
  - `END_DATE_UTC` string, date-time, required
  - `ALL_DAY` boolean
  - `DETAILS` string, string
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `REMINDER_DATE_UTC` string, date-time
  - `REMINDER_SENT` boolean
  - `OWNER_USER_ID` integer
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object

## Response `201`

Request succeeded.

- object
  - `EVENT_ID` integer
  - `TITLE` string, string
  - `LOCATION` string, string
  - `START_DATE_UTC` string, date-time, required
  - `END_DATE_UTC` string, date-time, required
  - `ALL_DAY` boolean
  - `DETAILS` string, string
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `REMINDER_DATE_UTC` string, date-time
  - `REMINDER_SENT` boolean
  - `OWNER_USER_ID` integer
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object
  - `LINKS` APILinkDto[]
    - `LINK_ID` integer
    - `OBJECT_NAME` string
    - `OBJECT_ID` integer
    - `LINK_OBJECT_NAME` string
    - `LINK_OBJECT_ID` integer
    - `ROLE` string
    - `DETAILS` string
    - `RELATIONSHIP_ID` integer
    - `IS_FORWARD` boolean

## Other responses

- `400`: Data validation error.
- `401`: Authentication failed.
- `402`: Record limit reached.

---

[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)