# Send

The `/send` endpoint allows you to send SMSs to your [contacts](https://docs.dripcel.com/concepts/contacts).

## **Send a single SMS**

`POST /send/sms`

Send a single SMS to a contact.

* 🔐 Permissions: `["sendLog.create"]`

### **Request**

**Body**

| **Field** | **Type** | **Required** | **Description** |
|-------|------|----------|-------------|
| `content` | `string` | ✅        | The content of the SMS. Can include templates **if** you're only sending to contacts in your org |
| `cell` | `string` | ✅        | The cell number of the [contact](https://docs.dripcel.com/concepts/contacts) you want to send the SMS to |
| `skipNonContacts` | `boolean` | ✅        | Whether to skip sending to contacts not in your org |
| `country` | `string` | ✅        | The country code to send to. |
| `deliveryMethod` | `'reverse'` \| `'standard'` \| `'transactional'` | ✅        | The [delivery method](https://docs.dripcel.com/concepts/campaigns#basic) to use. |
| `campaign_id` | `string` | ❌        | The id of the campaign to associate with this send. Allows hooks to trigger on reply. |
| `sendOptions` | `SendOptions` | ❌        | The options for the SMS |

**Example**

```javascript
{
  "content": "Hello World",
  "cell": "0111111111",
  "skipNonContacts": true,
  "country": "ZA",
  "deliveryMethod": "reverse",
  "campaign_id": "123",
  "sendOptions": {
    "testMode": true
  }
}
```

### **Response**


:::success
**Success**

:::

**200**

```javascript
{
  ok: true,
  data: {
    // A unique id identifying this particular send
    // Useful for querying the delivery status of this send
    customerId: string,
    totalCost: number,
  }
}
```


:::warning
**Error**

:::

**400**

```javascript
{
  ok: false;
  error: string;
}
```

## **Send bulk email**

`POST /send/email/bulk`

Send a bulk email to multiple recipients.

* 🔐 Permissions: `["sendLog.create"]`

### **Request**

**Body**

| **Field** | **Type** | **Required** | **Description** |
|-------|------|----------|-------------|
| `from` | `string` | ✅        | The email address to send form |
| `template_id` | `string` | ✅        | The _id of the [email template](https://docs.dripcel.com/API/email-templates) to send |
| `destinations` | `string[]` | ✅        | The list of email addresses to send to |
| `filter_non_contacts` | `boolean` | ❌        | Filter out email addresses that aren't in your Dripcel contacts. Required if the template you're sending contains custom fields to replace. |
| `to_start_at` | `string` | ❌        | Schedule to send for a future time. Default is to send immediately. |

**Example**

```javascript
{
  "from": "test@email.com",
  "template_id": "template123",
  "destinations": ["recipient@email.com"],
  "filter_non_contacts": true,
  "to_start_at": "2023-10-01T12:00:00Z"
}
```

### **Response**


:::success
**Success**

:::

**200**

```javascript
{
  ok: true,
  data: { }
}
```


:::warning
**Error**

:::

**400**

```javascript
{
  ok: false;
  error: string;
}
```