# Send SMS with admin privileges

Send an SMS message on behalf of another account using admin credentials.

Use case: Send SMS for other accounts without their credentials

Additional parameters: account and lra (Local Registration Authority)

Endpoint: POST /api/Admin/send
Version: 27.1.0.4
Security: basicAuth

## Request fields (application/json):

  - `destination` (string, required)
    Destination phone number in E.164 international format.

Format: +[country code][number] (e.g., +393401234567)
    Example: "+390000000000"

  - `text` (string, required)
    Message text to send.

Character limits:
- GSM-7: 160 chars (single), 153 chars (multi-part)
- UCS-2: 70 chars (single), 67 chars (multi-part)

Encoding: Automatically detected

Special characters: Emojis trigger UCS-2 (higher cost)

  - `reference` (object)
    Tracking reference to correlate SMS with your business logic. If any field is specified, service is required.

  - `reference.service` (string)
    Service identifier (e.g., AUTHENTICATION, ECOMMERCE, DIGITALSIGN). Required if action or key are specified. Must match one of the predefined allowed values — see [Reference Attribute](https://docs.namirial.app/products/sms/enterprise-documentation/developer-documentation/integration-guide/attribute-reference).

  - `reference.action` (string)
    Action within the service (e.g., 2FA, PASSWORD_RESET)

  - `reference.key` (string)
    Custom tracking key (e.g., user ID, order ID)

  - `detailed` (boolean)
    Return detailed response including provider name.

- true: Response includes provider
- false: Response without provider

  - `businessRelationId` (string)
    Business Relation Identifier for One Platform integration.

Overrides default business relation settings.

  - `webhook` (object)
    Webhook configuration for delivery status notifications.

See [Webhook Configuration](https://docs.namirial.app/products/sms/enterprise-documentation/developer-documentation/wb/wb-configuration) for details.

  - `webhook.url` (string)
    Webhook endpoint URL (must be HTTPS)

  - `webhook.authentication` (object)
    Authentication for webhook requests

  - `webhook.authentication.type` (string)
    Authentication type
    Enum: "NONE"

  - `webhook.authentication.value` (string)

  - `account` (string)
    Target account username to send SMS on behalf of

  - `lra` (integer)
    Local Registration Authority identifier

  - `attemptCount` (integer)
    DEPRECATED: No longer used. Retry logic is handled automatically.

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique message identifier (UUID). Use to query status via Message Status API.

  - `message` (string, required)
    Status message. Format: : . Code 0 = accepted.

  - `provider` (string,null)
    SMS provider used (only when detailed=true).

## Response 401 fields (application/json):

  - `code` (integer, required)
    Machine-readable error code.

See [Error Codes](https://docs.namirial.app/products/sms/enterprise-documentation/developer-documentation/integration-guide/error-codes) for complete list.
    Enum: 8, 56, 59, 60, 61, 63, 64, 66, 74

  - `message` (string, required)
    Human-readable error message

  - `details` (array,null)
    Additional error details or troubleshooting hints

## Response 500 fields (application/json):

  - `code` (integer, required)
    Machine-readable error code.

See [Error Codes](https://docs.namirial.app/products/sms/enterprise-documentation/developer-documentation/integration-guide/error-codes) for complete list.
    Enum: 8, 56, 59, 60, 61, 63, 64, 66, 74

  - `message` (string, required)
    Human-readable error message

  - `details` (array,null)
    Additional error details or troubleshooting hints


## Response 403 fields