Skip to main content
Wavix uses API keys for authentication. An API key is a unique identifier that you include in your API requests to verify your identity and authorize access. You authenticate your requests using the Authorization header with a Bearer token.

​
Get your API key

  1. Sign in to your Wavix account.
  2. Go to Administration → API Keys.
  3. Click Create new.
  4. Fill in the form:
    • Name (required): Enter a descriptive name, for example: “Mobile App Production”.
    • Restrict access to specific IP addresses (optional): Toggle to restrict access to specific IP addresses. Defaults to ON.
  5. Click Create.
After creating the key, you’ll return to the API keys table. To copy your API key, click the copy icon next to the masked API key in the table.

​
IP address restriction

Restricting access to specific IP addresses adds an extra layer of security. Even if your API key is compromised, it can only be used from your authorized servers. This is useful for backend services on fixed IPs, production environments, and compliance requirements.
Store your API key securely. Don’t share it publicly or commit it to version control. If your API key is compromised, revoke it immediately and generate a new one.

​
Authenticate your requests

Include your API key in the Authorization header using Bearer token format: 
Authorization: Bearer <your_api_key>
Replace <your_api_key> with your actual API key.

​
Code examples

Here are examples showing how to authenticate requests: 
curl -X GET "https://api.wavix.com/v3/messages?type=outbound" \
  -H "Authorization: Bearer your_api_key"
Keep your API key confidential. Don’t share it or expose it in public repositories, client-side code, or unsecured environments.

​
Manage API keys programmatically

You can create, list, and manage API keys using the API endpoints. For details, see the API Keys endpoint reference.

​
Deprecated method

Query parameter authentication using the appid parameter is deprecated and will be removed in a future version. Use Bearer token authentication instead.
Previously, you could authenticate requests by including your API key as the appid query parameter: 
GET https://api.wavix.com/v3/messages?appid=your_api_key
This method is still supported for backward compatibility, but we recommend migrating to Bearer token authentication as soon as possible.