Update a profile

Unlike a PUT request, a PATCH request will update only a portion of a recipient's profile. PATCH syntax is a little more complicated. Courier uses the JSON Patch syntax described below.

Imagine that we have a profile with an email and phone_number. We want to update only the email address.

"profile": {
  "email": "normanosborn@oscorp.com",
  "phone_number": "555-555-5555",
}

Our patch request body will be JSON. The first key in a JSON Patch object will be op, which stands for the operation you are to perform. This is assigned a value of add, remove, replace, move, copy, or test. We already have an email address present, so we will use replace.

We list the value to be replaced by pointing to it using the path key. This path takes a value pointing to the key we want to target. The path is built using "/" characters. Our email key is one level deep, so we will use "/email". We then have a value key that is assigned the value we want to replace our existing email with. The entire line looks like this:

{ "op": "replace", "path": "/email", "value": "test@example.com" }

To send the PATCH request, we send an array with our JSON Patch objects.

[{ "op": "replace", "path": "/email", "value": "test@example.com" }]

If you want to update multiple values, your patch will look like this:

[
  { "op": "replace", "path": "/email", "value": "test@example.com" },
  { "op": "replace", "path": "/phone_number", "value": "test@example.com" }
]

More Examples

The following types of requests will not change the body of an existing Profile:

JSON

// Empty Patch Array
{
  "patch": []
}

The above will result with:

200

{
  "status": "SUCCESS"
}

info

For more details about JSON Patch syntax:

• http://jsonpatch.com/
• https://tools.ietf.org/html/rfc6902

PATCHhttps://api.courier.com/profiles/:recipient_id

Apply a JSON Patch (RFC 6902) to the specified profile or create one if a profile doesn't already exist.

PATH PARAMS

recipient_idstringrequired

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

BODY PARAM

patcharray

An array of patch operations. Learn more

Responses

AUTH TOKEN

cURL

curl --request PATCH \
     --url https://api.courier.com/profiles/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: 'PATCH',
  headers: {
    Accept: 'application/json'
  },
};

fetch('https://api.courier.com/profiles/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/profiles/0460766e-8463-4905-ae98-b72c7aef41d6")

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

request = Net::HTTP::Patch.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/profiles/0460766e-8463-4905-ae98-b72c7aef41d6"

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

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

print(response.text)

Go

package main

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

func main() {

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

  req, _ := http.NewRequest("PATCH", 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('PATCH', 'https://api.courier.com/profiles/0460766e-8463-4905-ae98-b72c7aef41d6', [
  'headers' => [
    'Accept' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 OK400 Bad Request

{
  "status": "SUCCESS"
}

Example

Method: PATCH

URL: https://api.courier.com/profiles/abcdefgh12345678

Body: ​

{
  [
    {
      "op": "replace",
      "path": "/email",
      "value": "test@example.com"
    },
    {
      "op": "add",
      "path": "/phone_number",
      "value": "1234567890"
    }
  ]
}