# Introduction

Explore our complete API Reference Documentation to seamlessly integrate SMS messaging into your website or application using Mobivate’s Bulk SMS APIs.

Mobivate’s Bulk SMS APIs are built around standard HTTP verbs and a RESTful endpoint structure. API keys are used for authorization. All request and response payloads are formatted in JSON, making integration straightforward and predictable.

### Sending Messages

SMS message delivery is handled asynchronously. When you submit a message to our platform, we immediately acknowledge receipt of the request while delivery to the handset continues in the background.

If you have enabled Delivery Receipt notifications, these will be sent to your configured webhook endpoint as they are received by our system. We recommend storing and processing these receipts asynchronously on your side to ensure reliable delivery tracking.

<figure><img src="https://2259045641-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlQ6wwnR18L0Tgg5BKK13%2Fuploads%2F6522QX2VeX2Crkp9Pl1W%2Fimage.png?alt=media&#x26;token=9582f990-f714-4951-a353-17538a327f20" alt=""><figcaption></figcaption></figure>

### Authentication

Authentication to the Mobivate API is performed using **Bearer tokens**.

Once you have created an API key, it must be included in the `Authorization` header with every API request.

#### Example

```bash
-H "Authorization: Bearer YOUR_API_KEY"
```

You can create new API keys by following our guide on [Creating a new API key](https://wiki.mobivatebulksms.com/overview/introduction/creating-a-new-api-key).

{% hint style="warning" %}
Your API keys can grant access to your Mobivate account and should be treated as sensitive credentials.

Keep your API keys secure at all times and never share them or expose them in publicly accessible locations, such as client-side code repositories, public websites, or shared documentation.
{% endhint %}

### **API Base URL**

All examples in this documentation use a placeholder base URL:\
`https://api.vortex.example`

The production API domain is provided by our team upon request.