# Messaging Application Admin API

## Overview

Some of the messaging-related settings of your application — the ones you would
normally manage in the Cloud Softphone portal — can also be managed
programmatically through the **Messaging Application Admin API**.

## Getting access

The Messaging Application Admin API is not enabled by default. To start using it:

1. Contact Acrobits support and request access to the Messaging Application
   Admin API for your application.
2. Support will issue an **API key** for your application.
3. Store the API key securely — it grants full access to your application's Admin
   API and must be treated as a secret.

## Authentication

Each API key is bound to one application, identified by its `cloudId`. The
`cloudId` is part of every endpoint URL and determines which application a
request operates on; an API key is only valid for its own `cloudId`.

All requests must be authenticated with the API key, sent in an HTTP header:

```
x-app-api-key: <your-api-key>
```

Requests without a valid key for the `cloudId` in the URL are rejected with
`401 Unauthorized`.

## API base URL

All Messaging Application Admin API endpoints share a common host and base path that includes your `cloudId`. They are served over HTTPS from:

```
https://api-us.messaging.acrobits.cz/app-admin-api/{cloudId}/...
```

## Available APIs

| API | Description |
| --- | --- |
| [10DLC Application Admin API](10dlc-application-admin-api.md) | Manage the [10DLC](10dlc.md) settings (brand, contact info, custom welcome/opt-out/opt-in/help texts) for your application. |