---
title: "Send an RCS event"
method: POST
path: "/{connect_customer_key}/agentEvents/{msisdn}"
tags: ["RCS Business Messaging"]
---

# Send an RCS event

`POST /{connect_customer_key}/agentEvents/{msisdn}`

Sends an event from a Vibes customer RBM agent to a user. <br><br> Agent events include read receipts or "typing" notifications. If Vibes RBM can't reach the user, the Vibes RBM platform returns `404 NOT_FOUND`. Unlike agent messages, agent events cannot be revoked after sending.

## Path parameters

- `connect_customer_key` string, required
- `msisdn` string, required

## Query parameters

- `agentId` string, required
- `eventId` string

## Request body

- AgentEvent
  - `name` string — Do not set this field. It will be populated by the API when the operation returns.
  - `eventType` 'TYPE_UNSPECIFIED' | 'IS_TYPING' | 'READ', required
  - `messageId` string — If you are sending a read receipt event, the alphanumeric identifier of the message the read receipt is associated with.
  - `sendTime` string — Do not set this field. It will be populated by the API when the operation returns.

## Response `200`

The request has succeeded.

- AgentEvent
  - `name` string — Do not set this field. It will be populated by the API when the operation returns.
  - `eventType` 'TYPE_UNSPECIFIED' | 'IS_TYPING' | 'READ', required
  - `messageId` string — If you are sending a read receipt event, the alphanumeric identifier of the message the read receipt is associated with.
  - `sendTime` string — Do not set this field. It will be populated by the API when the operation returns.

## Other responses

- `403` — Forbidden agent. The `agentId` is either not valid, or it has not deployed on the provider.
- `422` — Unprocessable entity. Specific data errors have occurred in the request. Additional details will be available in the content of the error. <br><br> Example - Invalid Phone Number. The phone number is not a valid mobile number, or is on a unsupported carrier.
- `429` — Quota exceeded. You've either exceeded the number of calls allowed, or a downstream server is busy. Please try your request again later.

---

[API](https://skmtc.net/vibes/apis/vibes-rcs-business-messaging-api.md) · [All operations](https://skmtc.net/vibes/apis/vibes-rcs-business-messaging-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vibes/vibes-rcs-business-messaging-api/revisions/9004bf05c975/schema)