> ## Documentation Index
> Fetch the complete documentation index at: https://developer.z-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Send event

> Send an event message to a group

## Overview

With this method you can send Event type messages.

<Info>
  This message type can only be sent to a **group**.
</Info>

#### Example on WhatsApp

<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="https://mintcdn.com/z-api-8aa3bb40/nNYp_QHy_iUs4_xM/images/send-event-eng.jpg?fit=max&auto=format&n=nNYp_QHy_iUs4_xM&q=85&s=e3b5632fbc5414fcf1de2caee162bf97" width="400" data-path="images/send-event-eng.jpg" />
</div>

***

## Attributes

### Header

<ParamField path="instanceId" type="string" required>
  Your instance ID. Available in the Z-API panel under **Instances**.
</ParamField>

<ParamField path="token" type="string" required>
  Your Z-API instance token.
</ParamField>

### Required

<ParamField body="phone" type="string" required>
  Recipient group ID
</ParamField>

<ParamField body="event" type="object" required>
  Event data

  <Expandable title="Properties">
    <ParamField body="name" type="string" required>
      Event name
    </ParamField>

    <ParamField body="dateTime" type="string" required>
      Event date and time (without timezone). E.g.: 2024-04-29T09:30:53.309Z
    </ParamField>

    <ParamField body="description" type="string">
      Event description
    </ParamField>

    <ParamField body="timeZone" type="string">
      Event UTC timezone. E.g.: UTC-3
    </ParamField>

    <ParamField body="location" type="object">
      Event location

      <Expandable title="Properties">
        <ParamField body="name" type="string">
          Place name
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField body="callLinkType" type="string">
      Event call type: `voice` or `video`
    </ParamField>

    <ParamField body="canceled" type="boolean">
      Whether the event is canceled
    </ParamField>
  </Expandable>
</ParamField>

***

## Request Body

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "phone": "120363019502650977-group",
  "event": {
    "name": "Event name",
    "description": "Event description",
    "dateTime": "2024-04-29T09:30:53.309Z",
    "timeZone": "UTC-3",
    "location": {
      "name": "Place name"
    },
    "callLinkType": "voice",
    "canceled": false
  }
}
```

***

## Response

### 200

```json theme={"theme":{"light":"github-light","dark":"poimandres"}}
{
  "zaapId": "3999984263738042930CD6ECDE9VDWSA",
  "messageId": "D241XXXX732339502B68",
  "id": "D241XXXX732339502B68"
}
```

### 405

Make sure you are correctly sending the method specification, that is, verify that you sent POST or GET as specified at the beginning of this topic.

### 415

If you receive a 415 error, make sure to add the "Content-Type" header to your request, which in most cases is "application/json".