---
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}`

## Request

- Base URL: `https://rbm.us.vibes.com/connectCustomers`
- URL: `https://rbm.us.vibes.com/connectCustomers/{connect_customer_key}/agentEvents/{msisdn}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://vibes-rbm-prd.auth.us-west-2.amazoncognito.com/oauth2/token` scopes: `https://rbm.vibes.com/rbm.agents`

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.dev/vibes/apis/vibes-rcs-business-messaging-api.md) - [All operations](https://skmtc.dev/vibes/apis/vibes-rcs-business-messaging-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vibes/apis/vibes-rcs-business-messaging-api/revisions/94076f49389f?raw)