---
schema_version: "1"
id: 28d51a9cd0a397c1e1b94f9fe1424df9ddb8e221bcffc01b7590ee9f38544362
title: POST /sms/v1/automation/importSend
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/importSend.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_sms/importSend.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: c970bab1ba969e6b6939e4ecf1342645341637145d20e4298cc426cbbb5cd1a0
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# POST /sms/v1/automation/importSend

## Overview

Imports the contact file and data extension, and then sends the message. This API is only supported for Outbound Message template.

### JSON Parameters

<!--complex table-->

| Name                     | Type    |              | Description                                                                     |
| ------------------------ | ------- | ------------ | ------------------------------------------------------------------------------- |
| **messageId**            | string  | **Required** | Encoded message Id                                                              |
| **keyword**              | string  | **Required** | A valid keyword on the shortcode for the message to opt the numbers on to       |
| **notificationEmail**    | string  |              | If specified, email notifications will be sent on import and program completion |
| **override**             | boolean |              | Flag to indicate whether the override text should be used                       |
| **overrideText**         | string  |              | Text to override the existing message.                                          |
| **isDuplicationAllowed** | boolean |              | If true, duplicate messages may be sent                                         |
| **isVisible**            | boolean |              | If specified true, the import definition and list created will be visible       |
| **importDefinition**     | string  | **Required** | List of Import Definitions to be created (currently limited to 1)               |

### Usage

**Example Request for FILE ImportType**

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /sms/v1/automation/importSend
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "MessageId": "MessageId",
  "Keyword": "Test_Keyword",
  "NotificationEmail": "myEmail@example.com",
  "IsDuplicationAllowed" : true,
  "ImportDefinition": [{
    "FileName": "MyTestList.csv",
    "ImportType": "FILE",
    "ImportMappingType": "ManualMap",
    "FieldMaps": [{
      "Destination": "_FirstName",
      "Source": "First Name"
    }, {
      "Destination": "_Subscriberkey",
      "Source": "Subscriber Key"
    }, {
      "Destination": "_LastName",
      "Source": "Last Name"
    }, {
      "Destination": "_MobileNumber",
      "Source": "Mobile"
    }, {
      "Destination": "_CountryCode",
      "Source": "Country"
    }]
  }]
}
```

**Example Request for DATA_EXTENSION ImportType**

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /sms/v1/automation/importSend
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "MessageId": "MessageId",
  "Keyword": "Test_Keyword",
  "NotificationEmail": "myEmail@example.com",
  "Override": true,
  "OverrideText": "Override Text for Demo!",
  "IsDuplicationAllowed" : true,
  "ImportDefinition": [{
    "ImportType": "DATA_EXTENSION",
    "ImportMappingType": "InferFromColumnHeadings",
    "DataExtensionName": "MyDataExtension",
    "IsFirstRowHeader": true
  }]
}
```

**Example Response**

```js
HTTP/1.1 202 Accepted
{
    "tokenId": "NDo8NDow",
    "lastPublishDate": "2012-12-18T15:38:12.030Z"
}
```