# Send an event

Sends an event to the referenced contact from the referenced app.
Note that this operation enqueues the event in a queue so a successful
response only indicates that the event has been queued.

Endpoint: POST /v1/projects/{project_id}/events:send
Version: 1.0
Security: Basic, oAuth2

## Path parameters:

  - `project_id` (string, required)
    The unique ID of the project. You can find this on the Sinch Dashboard.

## Request fields (application/json):

  - `app_id` (string, required)
    The ID of the app sending the event.

  - `recipient` (object, required)
    Identifies the recipient. If [Dispatch Mode](https://developers.sinch.com/docs/conversation/processing-modes/) is used, you must use the identified_by field.

  - `event` (object, required)

  - `event.app_event` (object)
    Event originating from an app

  - `callback_url` (string)
    Overwrites the default callback url for delivery receipts for this message
The REST URL should be of the form: http://host[:port]/path

  - `channel_priority_order` (array)
    Optional. A single element array that dictates on what channel should
the Conversation API try to send the event.
It overrides any default set on the contact. Providing more than one
option has no effect.
    Enum: "WHATSAPP", "RCS", "SMS", "MESSENGER", "VIBERBM", "MMS", "INSTAGRAM", "TELEGRAM", "KAKAOTALK", "KAKAOTALKCHAT", "LINE", "WECHAT", "APPLEBC"

  - `event_metadata` (string)
    Optional. Eventual metadata that should be associated to the event.

  - `queue` (string)
    Select the priority type for the message
    Enum: "NORMAL_PRIORITY", "HIGH_PRIORITY"

## Response 200 fields (application/json):

  - `accepted_time` (string)
    Accepted timestamp.

  - `event_id` (string)
    Event id.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (integer)

  - `error.details` (array)

  - `error.details.type_url` (string)

  - `error.details.value` (string)

  - `error.message` (string)

  - `error.status` (string)

## Response 403 fields (application/json):

  - `error` (object)

  - `error.code` (integer)

  - `error.details` (array)

  - `error.details.type_url` (string)

  - `error.details.value` (string)

  - `error.message` (string)

  - `error.status` (string)

## Response 500 fields (application/json):

  - `error` (object)

  - `error.code` (integer)

  - `error.details` (array)

  - `error.details.type_url` (string)

  - `error.details.value` (string)

  - `error.message` (string)

  - `error.status` (string)

## Response 501 fields (application/json):

  - `error` (object)

  - `error.code` (integer)

  - `error.details` (array)

  - `error.details.type_url` (string)

  - `error.details.value` (string)

  - `error.message` (string)

  - `error.status` (string)