---
title: "Send an event"
method: POST
path: "/v1/projects/{project_id}/events:send"
tags: ["Events"]
---

# Send an event

`POST /v1/projects/{project_id}/events:send`

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.

## Request body

- SendEventRequest
  - `app_id` string, required — The ID of the app sending the event.
  - `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` ConversationChannel[] — 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.
  - `event` AppEventField, required
    - `app_event` union — Event originating from an app
      - object
        - `composing_event` object — Represents a typing indicator shown to the contact.
      - object
        - `composing_end_event` object — Represents a typing-end indicator. Stops a typing indicator previously shown to the contact.
      - object
        - `read_message_event` object — Marks an inbound (contact) message as read on the channel, producing a read receipt for the contact. Supported on the WhatsApp channel.
      - object
        - `comment_reply_event` object — Represents a response to a comment event.
          - `text` string, required — The text of the comment reply.
      - object
        - `agent_joined_event` object
          - `agent` Agent, required — Represents an agent that is involved in a conversation.
            - `display_name` string — Agent's display name
            - `type` 'UNKNOWN_AGENT_TYPE' | 'HUMAN' | 'BOT' — Agent's classification. It can be UNKNOWN_AGENT_TYPE, HUMAN or BOT.
            - `picture_url` string — The Agent's picture url.
      - object
        - `agent_left_event` object
          - `agent` Agent, required — Represents an agent that is involved in a conversation.
            - `display_name` string — Agent's display name
            - `type` 'UNKNOWN_AGENT_TYPE' | 'HUMAN' | 'BOT' — Agent's classification. It can be UNKNOWN_AGENT_TYPE, HUMAN or BOT.
            - `picture_url` string — The Agent's picture url.
      - object
        - `generic_event` object — Event that contains only a flexible payload field.
          - `payload` object, required — Arbitrary data set to the event. A valid JSON object.
  - `event_metadata` string — Optional. Eventual metadata that should be associated to the event.
  - `queue` 'NORMAL_PRIORITY' | 'HIGH_PRIORITY' — Select the priority type for the message
  - `recipient` union, required
    - object
      - `identified_by` ChannelIdentities
        - `channel_identities` ChannelRecipientIdentity[], required — A list of specific channel identities. The API will use these identities when sending to specific channels.
          - `channel` 'SMS' | 'RCS' | 'WHATSAPP' | 'MMS' | 'KAKAOTALK' | 'KAKAOTALKCHAT' | 'VIBERBM' | 'LINE' | 'INSTAGRAM' | 'MESSENGER' | 'WECHAT' | 'TELEGRAM' | 'APPLEBC', required — The identifier of the channel you want to include. Must be one of the enum values.
          - `identity` string, required — The channel recipient identity.
    - object
      - `contact_id` string — The ID of the contact.

## Response `200`

A successful response.

- SendEventResponse
  - `accepted_time` string, date-time — Accepted timestamp.
  - `event_id` string — Event id.

## Other responses

- `400` — Malformed request. See [common error responses](https://developers.sinch.com/docs/conversation/api-reference/#common-error-responses) for more information.
- `401` — Incorrect credentials. See [common error responses](https://developers.sinch.com/docs/conversation/api-reference/#common-error-responses) for more information.
- `403` — Correct credentials but you don't have access to the requested resource. See [common error responses](https://developers.sinch.com/docs/conversation/api-reference/#common-error-responses) for more information.
- `500` — Correct credentials but you don't have access to the requested resource. See [common error responses](https://developers.sinch.com/docs/conversation/api-reference/#common-error-responses) for more information.
- `501` — Something went wrong on our end, try again with exponential back-off. See [common error responses](https://developers.sinch.com/docs/conversation/api-reference/#common-error-responses) for more information.

---

[API](https://skmtc.net/sinch/apis/conversation-api-sinch.md) · [All operations](https://skmtc.net/sinch/apis/conversation-api-sinch/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/conversation-api-sinch/revisions/bdb3e0c48bf7/schema)