---
title: "POST /crm/interaction"
method: POST
path: "/crm/interaction"
tags: ["CRM"]
---

# POST /crm/interaction

`POST /crm/interaction`

Creates or Updates the customer (if existing) and adds an interaction under that customer.

## Request body

- Interaction — Schema for add interaction Body
  - `customer` object, required — Customer details
    - `name` string, required — Name of the customer
    - `phoneNumber` string, required — Phone number of the customer with country code
    - `email` string, nullable — Email of the customer
    - `company` object, nullable — Company details of the customer
      - `name` string, nullable — Name of the company
      - `address` object, nullable — Address of the company
        - `street` string, nullable — Street name
        - `city` string, nullable — City name
        - `state` string, nullable — State name
        - `country` string, nullable — Country name
        - `pincode` number, nullable — Pincode
      - `kdm` object, nullable — Key decision maker details of the company
        - `name` string, nullable — Kdm name
        - `phoneNumber` string, nullable — Phone number of the kdm
  - `priority` 3 | 2 | 1 | -1, nullable — Priority of the customer. 3 -> HIGH, 2 -> MEDIUM, 1 -> LOW, -1 -> NOT MENTIONED
  - `notes` string, nullable — Remarks given by the user
  - `processName` string, nullable — Process name in which this customer should be assigned
  - `userFields` object[], nullable — User defined crm fields for the customer
    - `name` string, required — Name of the crm field. Should be same as the one defined in the excel template/crm fields in the admin panel
    - `value` union, required — Value of the crm field. For date field, provide epoch value in seconds
      - string
      - number
  - `assignedTo` string — Phone number of the user to which this interaction should be assigned. Phone number should have country code in it. If omitted the interaction gets assigned to the user whose api-key is used.

## Response `200`

If the auth token is valid.

- AddInteractionSuccess — Schema for success response
  - `message` string
  - `statusCode` number

## Other responses

- `403` — UnAuthorized.

---

[API](https://skmtc.dev/runo/apis/api-documentation.md) · [All operations](https://skmtc.dev/runo/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runo/api-documentation/revisions/19460dffac44/schema)