PHP Quickstart

1. Make sure you have the latest version of PHP installed.
2. Sign up for Courier to get access to your API key.
3. Add the channel(s) you wish to send your message to.
4. Run composer require trycourier/courier to install the Courier PHP SDK.
5. Add the following code to your PHP file and replace <auth_token> with your Courier API key:

<?php
  require "./vendor/autoload.php";
  use Courier\CourierClient;

    $courier = new CourierClient(https://api.courier.com/send, "YOUR_AUTH_TOKEN_HERE");

    $result = $courier->sendEnhancedNotification(
      (object) [
        'to' => [
          'email' => "email@example.com",
        ],
        'content' => [
          'title' => "Welcome!",
          'body' => "Thanks for signing up, {{name}}",
        ],
        'data' => [
          'name' => "Peter Parker",
        ],
        'routing' => [
          'method' => "single",
          'channels' => ["email"],
        ],
      ],
    );

    echo( $result->requestId );
?>

6. Replace the JSON within the body to match the type and content of notification you want to send. There are 4 main properties within this example notification:

   • to: provide information used by Courier to identify the recipient of the notification. Here you can include details such as the recipient’s email address for email, phone number for SMS.
   • content: add your notification’s title and body.
   • data: include any data you want to pass to a message template. The data will populate the corresponding template variables.
   • routing: customize which channel(s) Courier will potentially deliver the message. If no routing key is specified, Courier will use the default routing configured in the Courier Studio UI.

   Explore how to customize your notification with more properties >

7. Run your code. Upon running this API call, only a requestId will be returned.

   { "requestId": "87e7c05b-4f46-fda24e356e23" }
   

8. Monitor the status of your notification (once sent) in the logs: https://app.courier.com/logs

​

FAQs

​

Questions?

Join our developer community on Discord and ask questions in the #ask-support channel.