REST API v3: PUT webhook

This method is used to update an existing webhook with the REST API. It uses an HTTP PUT request to the following address:

https://api.copernica.com/v3/webhook/$id?access_token=xxxx

Replace the $id with the identifier of the webhook you want to edit.

Available parameters

Parameter Description
handler The URL of the webhook's endpoint that wil handle the call.
trigger The event that will trigger this webhook.
callers Specify what callers may trigger the webhook. This parameter is optional. If no callers are specified, all possible callers are applied.

Trigger can be one of the following

  • create: profile creations
  • update: profile updates
  • delete: profile deletions
  • click: clicks
  • delivery: deliveries
  • open: impressions
  • bounce: bounces
  • failure: errors

JSON example

The following JSON demonstrates how to use the API method:

{  
   "handler":"https://my-webhook-url.com",
   "trigger":"create",
   "callers":["ms", "publisher"]
}

PHP example

The following PHP script demonstrates how to use the API method:

// dependencies
require_once("copernica-rest-api.php");

// change this into your access token
$api = new CopernicaRestAPI("your-access-token", 3);

// data to be sent to the api
$data = array(
    "handler"   =>  "https://my-webhook-url.com",
    "trigger"   =>  "create",
    "callers"   =>  array("publisher","ms")
);

// do the call
$api->put("webhook/{$id}", $data);

The example above requires the CopernicaRestApi class.

More information