PUT /preferences/:recipient_id

URL: https://api.courier.com/preferences/:recipient_id

Method: PUT

PATH PARAMS

recipient_idstringrequired

A unique identifier representing the recipient associated with the requested profile.

BODY PARAMS

notificationsrecord

json object that contains notification ids with the respective preferences

categoriesrecord

json object that contains category ids with the respective preferences

RESPONSES:

status: 200 OK

statusstring

status: 400 Bad Request

messagestring

A message describing the error that occurred.

typestring

[invalid_request_error] The type of error that occurred.

Request Example

cURL

curl --request PUT \
     --url https://api.courier.com/preferences/0460766e-8463-4905-ae98-b72c7aef41d6 \
     --header 'Accept: application/json' 

Node.js

// Dependencies to install:
// $ npm install node-fetch --save

const fetch = require('node-fetch');

const options = {
  method: 'PUT',
  headers: {
    Accept: 'application/json'
  },
};

fetch('https://api.courier.com/preferences/0460766e-8463-4905-ae98-b72c7aef41d6', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Ruby

require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://api.courier.com/preferences/0460766e-8463-4905-ae98-b72c7aef41d6")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Accept"] = 'application/json'

response = http.request(request)
puts response.read_body

Python

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://api.courier.com/preferences/0460766e-8463-4905-ae98-b72c7aef41d6"

headers = {
  "Accept": "application/json"
}

response = requests.request("PUT", url, headers=headers)

print(response.text)

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.courier.com/preferences/0460766e-8463-4905-ae98-b72c7aef41d6"

  req, _ := http.NewRequest("PUT", url, payload)

  req.Header.Add("Accept", "application/json")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('PUT', 'https://api.courier.com/preferences/0460766e-8463-4905-ae98-b72c7aef41d6', [
  'headers' => [
    'Accept' => 'application/json',
  ],
]);

echo $response->getBody();

Responses Example

{
  "status": "SUCCESS"
}

{
  "message": "Error Message",
  "type": "invalid_request_error"
}