---
title: "POST /crmEvent"
method: POST
path: "/crmEvent"
tags: ["crmEvent"]
---

# POST /crmEvent

`POST /crmEvent`

## Request

- Base URL: `https://www.weclapp.com/api/nullapi/v2`
- URL: `https://www.weclapp.com/api/nullapi/v2/crmEvent`
- Auth: API key in header `AuthenticationToken`
- TypeScript: <https://skmtc.dev/weclapp/apis/weclapp-api/docs/crmEvent/post.ts> (a function with typed inputs; its response is checked against the schema)

create a crmEvent

## Query parameters

- `dryRun` boolean

## Request body

- CrmEvent
  - `id` string
  - `version` string
  - `calendarEventId` string
  - `callCategoryId` string
  - `contactId` string
  - `createdDate` integer
  - `creatorUserId` string
  - `customAttributes` CustomAttribute[]
    - `attributeDefinitionId` string
    - `booleanValue` boolean
    - `dateValue` integer
    - `entityId` string
    - `entityReferences` EntityReference[]
      - `entityId` string
      - `entityName` string
    - `numberValue` string, number
    - `selectedValueId` string
    - `selectedValues` OnlyId[]
      - `id` string
    - `stringValue` string
  - `description` string
  - `endDate` integer
  - `eventCategoryId` string
  - `lastModifiedDate` integer
  - `location` string
  - `opportunityId` string
  - `partyId` string, required
  - `startDate` integer
  - `subject` string, required
  - `tags` string[]
  - `type` 'GENERAL' | 'INCOMING_CALL' | 'LETTER' | 'OUTGOING_CALL', required

## Response `201`

crmEvent create response

- CrmEvent
  - `id` string
  - `version` string
  - `calendarEventId` string
  - `callCategoryId` string
  - `contactId` string
  - `createdDate` integer
  - `creatorUserId` string
  - `customAttributes` CustomAttribute[]
    - `attributeDefinitionId` string
    - `booleanValue` boolean
    - `dateValue` integer
    - `entityId` string
    - `entityReferences` EntityReference[]
      - `entityId` string
      - `entityName` string
    - `numberValue` string, number
    - `selectedValueId` string
    - `selectedValues` OnlyId[]
      - `id` string
    - `stringValue` string
  - `description` string
  - `endDate` integer
  - `eventCategoryId` string
  - `lastModifiedDate` integer
  - `location` string
  - `opportunityId` string
  - `partyId` string, required
  - `startDate` integer
  - `subject` string, required
  - `tags` string[]
  - `type` 'GENERAL' | 'INCOMING_CALL' | 'LETTER' | 'OUTGOING_CALL', required

## Other responses

- `default`: error response

## Changes

- **2026-11-07** `0e021229755d`: 1 info
  - added the new optional `query` request parameter `dryRun`
- **2023-05-10** `b7b4270a0f69`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weclapp/apis/weclapp-api/changes/crmEvent/post.md)

---

[API](https://skmtc.dev/weclapp/apis/weclapp-api.md) - [All operations](https://skmtc.dev/weclapp/apis/weclapp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weclapp/apis/weclapp-api/revisions/0e021229755d?raw)