API Authentication

Sendzovo uses Bearer tokens for REST API authentication. Sending and verification operations use separate API credential types.

Authorization: Bearer YOUR_SENDING_API_KEY

Authorization: Bearer YOUR_VERIFICATION_API_KEY

Credential comparison

REST authentication examples

curl "https://api.sendzovo.com/v1/messages/MESSAGE_ID" \
  -H "Authorization: Bearer YOUR_SENDING_API_KEY"

<?php

require 'vendor/autoload.php';

use Sendzovo\Client;

$sendzovo = Client::withSendingKey(
    $_ENV['SENDZOVO_SENDING_API_KEY']
);

$message = $sendzovo->messages()->get(
    'MESSAGE_ID'
);

print_r($message);

const response = await fetch(
  "https://api.sendzovo.com/v1/messages/MESSAGE_ID",
  {
    headers: {
      "Authorization":
        "Bearer YOUR_SENDING_API_KEY"
    }
  }
);

const data = await response.json();

console.log(data);

import requests

response = requests.get(
    "https://api.sendzovo.com/v1/messages/MESSAGE_ID",
    headers={
        "Authorization":
            "Bearer YOUR_SENDING_API_KEY"
    },
)

print(response.json())

using System.Net.Http.Headers;

using var client = new HttpClient();

client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue(
        "Bearer",
        "YOUR_SENDING_API_KEY"
    );

var response = await client.GetAsync(
    "https://api.sendzovo.com/v1/messages/MESSAGE_ID"
);

var result =
    await response.Content.ReadAsStringAsync();

Console.WriteLine(result);

Environment variables

Store API credentials in environment variables or another secure secret-management system instead of hard-coding them into application source code.

SENDZOVO_SENDING_API_KEY=your_sending_api_key
SENDZOVO_VERIFICATION_API_KEY=your_verification_api_key

PHP SDK authentication

<?php

use Sendzovo\Client;

$sendzovo = Client::withSendingKey(
    $_ENV['SENDZOVO_SENDING_API_KEY']
);

For email verification:

<?php

use Sendzovo\Client;

$sendzovo = Client::withVerificationKey(
    $_ENV['SENDZOVO_VERIFICATION_API_KEY']
);

Using both credentials

An application that sends email and performs email verification can initialize the SDK with both credentials.

<?php

use Sendzovo\Client;

$sendzovo = new Client(
    sendingApiKey: $_ENV['SENDZOVO_SENDING_API_KEY'],
    verificationApiKey: $_ENV['SENDZOVO_VERIFICATION_API_KEY'],
);