# Send an E-Invoice via Email

You can use this API to send an E-Invoice via Email to your customers. 

### Request Method <a href="#request-method" id="request-method"></a>

POST

### **Request URL**

```
{{HOST}}/einv/v0/communication/send
```

### Request Headers

<table><thead><tr><th>Parameter</th><th width="158">Data Type</th><th width="183.3333740234375">Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>X-Cleartax-Auth-Token</td><td>String</td><td>NA</td><td>Mandatory. The auth token generated from the ClearTax user id and password. </td></tr><tr><td>gstin</td><td>String</td><td>NA</td><td>Users GSTIN</td></tr></tbody></table>

### Request Path Params <a href="#request-path-params" id="request-path-params"></a>

There are no path parameters for this API.

### Request Query Params <a href="#request-path-params" id="request-path-params"></a>

There are no query parameters for this API.

### Request Body

<table><thead><tr><th>Parameter</th><th width="157.3333740234375">Data Type</th><th width="183">Field Validations </th><th>Description</th></tr></thead><tbody><tr><td>attachment_details</td><td>Object</td><td>NA</td><td>Mandatory, Attachment Details</td></tr><tr><td>communication_details</td><td>Object</td><td>NA</td><td>Mandatory, Communication Details like Template Type and Email Information</td></tr></tbody></table>

#### Attachment Details Object

<table><thead><tr><th>Parameter</th><th width="162.6666259765625">Data Type</th><th>Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>invoice_details</td><td>Object</td><td>NA</td><td>Mandatory, Invoice Details for which E-Invoice is to be sent in attachments</td></tr></tbody></table>

**Invoice Details Object**

<table><thead><tr><th>Parameter</th><th width="158.6666259765625">Data Type</th><th>Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>invoice_id</td><td>String</td><td><p>minLength: 1
</p><p>maxLength: 16
</p><p>pattern: "^([a-zA-Z1-9]{1}[a-zA-Z0-9\/-]{0,15})$"</p></td><td>Mandatory, Invoice/ Document Number</td></tr><tr><td>invoice_date</td><td>String</td><td>Format DD/MM/YYYY</td><td>Mandatory, Document Date</td></tr><tr><td>invoice_type</td><td>Enum</td><td>Enum Values: INV, CDN, DBN</td><td>Mandatory, Document Type: Invoice, Credit Note, or Debit Note</td></tr></tbody></table>

#### Communication Details

<table><thead><tr><th>Parameter</th><th width="161.3333740234375">Data Type</th><th>Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>template</td><td>Object</td><td>NA</td><td>Mandatory, Template Type</td></tr><tr><td>contacts</td><td>List</td><td>NA</td><td>Mandatory, Contact Details</td></tr></tbody></table>

**Template Details Object**

<table><thead><tr><th>Parameter</th><th width="163.33331298828125">Data  Type</th><th>Validations</th><th>Description</th></tr></thead><tbody><tr><td>template_type</td><td>String</td><td>INVOICE_GENERATED, INVOICE_CANCELLED, INVOICE_PAYMENT_REMINDER</td><td>Mandatory</td></tr></tbody></table>

**Contact Details**

<table><thead><tr><th>Parameter</th><th width="162.66668701171875">Data Type</th><th>Field Validations </th><th>Description</th></tr></thead><tbody><tr><td>recipients</td><td>List</td><td>NA</td><td>Mandatory, Email Recipients - You can send multiple recipients for sending email</td></tr></tbody></table>

**Email Recipient Details**

<table><thead><tr><th>Parameter</th><th width="164">Data Type</th><th>Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>maxLength: 100</td><td>Optional, Name of the Person</td></tr><tr><td>email</td><td>String</td><td>maxLength:100</td><td>Mandatory, Email of the Person</td></tr><tr><td>email_recipient_type</td><td>Enum</td><td>TO, CC, BCC</td><td>Mandatory, Scope of the Email</td></tr></tbody></table>

### Response Status Codes <a href="#response-status-codes" id="response-status-codes"></a>

| HTTP Status Code | Description                                                                  |
| ---------------- | ---------------------------------------------------------------------------- |
| 200              | For a successfully processed request (may be a success or validation error). |
| 401              | If the user is not authenticated for the operation.                          |
| 403              | If the user is not authorised for the operation.                             |
| 500              | If there are any unhandled exceptions on the Clear side.                     |

### Response Schema

<table><thead><tr><th width="180.66668701171875">Parameter</th><th width="150.33331298828125">Data Type</th><th>Field Validations</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>true, false</td><td><p><strong>true</strong> if request is successful, </p><p><strong>false</strong> if request got failed</p></td></tr><tr><td>errors</td><td>Object</td><td>NA</td><td>Details of errors, null in case of success</td></tr></tbody></table>

#### Error Details Object

<table><thead><tr><th width="181.33331298828125">Parameter</th><th width="148.66668701171875">Data Type</th><th>Field Validations </th><th>Description</th></tr></thead><tbody><tr><td>error_code</td><td>String</td><td>NA</td><td>Error Code </td></tr><tr><td>error_message</td><td>String</td><td>NA</td><td>Error Message</td></tr><tr><td>error_source</td><td>String</td><td>ClearTax</td><td>Error Source</td></tr></tbody></table>

### Sample Request and Response <a href="#sample-request-and-response" id="sample-request-and-response"></a>

#### **Request**

```json
{
  "attachment_details": {
   "printTemplate": "62cfd0a9-d1ed-47b0-b260-f8y6f57e9c5e",
   "invoice_details": {
      "invoice_id": "DOC-1",
      "invoice_date": "24/06/2025",
      "invoice_type": "INV"
    }
  },
  "communication_details": {
    "template": {
      "template_type": "INVOICE_GENERATED"
    },
    "contacts": [
      {
        "recipients": [
          {
            "name": "Contact Person Name",
            "email": "recipient@gmail.com",
            "email_recipient_type": "TO"
          }
        ]
      }
    ]
  }
}
```

#### Response - Success:&#x20;

**HTTP Status Code : 200 OK**

```json
{
    "success": true,
    "errors": null
}
```

#### Response - Failure:&#x20;

**HTTP Status Code : 200 OK**

```json
{
    "success": false,
    "errors": {
        "error_code": "300102",
        "error_message": "You don't have any data present for the selected Document Details",
        "error_source": "CLEARTAX"
    }
}
```

#### API Validations <a href="#api-validations" id="api-validations"></a>

Currently there are no known validations for this API.

#### API Constraints <a href="#api-constraints" id="api-constraints"></a>

The Invoice should be present in the ClearTax database.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cleartax.in/cleartax-docs/e-invoicing-api/e-invoicing-api-reference/cleartax-e-invoicing-apis-xml-schema/b2b-e-invoicing-apis/send-an-e-invoice-via-email.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.