Authentication

The Unified Communications Platform uses API Key authentication for secure access to all endpoints.

Getting Your API Key

  1. 1. Log in to your account at unicom360.com
  2. 2. Navigate to Settings → Credentials
  3. 3. Create a new API credential or copy your existing API key

API Key Header

/api/v1/json/*

Method: X-API-Key Header

Pass your API key in the X-API-Key request header

Bearer Token

/api/v1/json/*

Method: Authorization: Bearer

Pass your API key as a Bearer token in the Authorization header

Method 1: X-API-Key Header (Recommended)

curl -X POST https://api.unicom360.com/api/v1/json/bulk/sms \
-H "X-API-Key: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"sender_id": "COMPANY", "message_body": "Hello!", "recipient": ["26097123456"]}'

Method 2: Bearer Token

curl -X POST https://api.unicom360.com/api/v1/json/bulk/sms \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"sender_id": "COMPANY", "message_body": "Hello!", "recipient": ["26097123456"]}'

Method 3: Basic Authentication (Legacy)

For backward compatibility, Basic Auth is still supported using your API key as the username.

curl -X POST https://api.unicom360.com/api/v1/json/bulk/sms \
-u "your_api_key_here:" \
-H "Content-Type: application/json" \
-d '{"sender_id": "COMPANY", "message_body": "Hello!", "recipient": ["26097123456"]}'

Security Features

IP Whitelisting

Restrict API access to specific IP addresses for enhanced security.

Key Expiration

Set optional expiration dates for API keys to maintain security hygiene.

Rate Limiting

Configurable rate limits per API key to prevent abuse.

Usage Tracking

Monitor API key usage with last-used timestamps and request logs.