Update an audience

A audience_id should be uniquely identifiable using a string ID that will not change.

Examples

JSON

{
  "name": "Developers from San Francisco",
  "filter": {
    "operator": "AND",
    "filters": [
      {
        "path": "location",
        "operator": "EQ",
        "value": "San Francisco"
      },
      {
        "path": "job_title",
        "operator": "EQ",
        "value": "Developer"
      }
    ]
  }
}

The above will result with:

200

{
  "audience": {
    "id": "<audience-id>",
    "name": "My favorite people",
    "description": "People I like",
    "created_at": "<iso-8601-formatted-string>",
    "updated_at": "<iso-8601-formatted-string>",
    "filter": {
      "operator": "AND",
      "filters": [
        {
          "path": "location",
          "operator": "EQ",
          "value": "San Francisco"
        },
        {
          "path": "job_title",
          "operator": "EQ",
          "value": "Developer"
        }
      ]
    }
  }
}

PUThttps://api.courier.com/audiences/:audience_id

Creates or updates audience.

PATH PARAMS

audience_idstringrequired

A unique identifier representing the audience id

BODY PARAM

idstring

A unique identifier representing the audience_id

namestring

The name of the audience

descriptionstring

A description of the audience

filteroneOfrequired

Either a single filter or a group of filters

operatorstring

The operator to use for filtering

ENDS_WITHEQEXISTSGTGTEINCLUDESIS_AFTERIS_BEFORELTLTENEQOMITSTARTS_WITH

valuestring

The value to use for filtering

pathstring

The attribe name from profile whose value will be operated against the filter value

Responses

AUTH TOKEN

cURL

curl --request PUT \
     --url https://api.courier.com/audiences/my-favorite-developer-audience \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '
{
  "id": "developer-audience",
  "name": "Developer Audience",
  "description": "Audience for developers"
}
'

Node.js

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

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

const options = {
  method: 'PUT',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "id": "developer-audience",
    "name": "Developer Audience",
    "description": "Audience for developers"
  })
};

fetch('https://api.courier.com/audiences/my-favorite-developer-audience', 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/audiences/my-favorite-developer-audience")

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

request = Net::HTTP::Put.new(url)
request["Accept"] = 'application/json'
request["Content-Type"] = 'application/json'
request.body = "{\"id\":\"developer-audience\",\"name\":\"Developer Audience\",\"description\":\"Audience for developers\"}"

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

Python

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

import requests

url = "https://api.courier.com/audiences/my-favorite-developer-audience"

payload = {
  "id": "developer-audience",
  "name": "Developer Audience",
  "description": "Audience for developers"
}
headers = {
  "Accept": "application/json",
  "Content-Type": "application/json"
}

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

print(response.text)

Go

package main

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

func main() {

  url := "https://api.courier.com/audiences/my-favorite-developer-audience"

  payload := strings.NewReader("{\"id\":\"developer-audience\",\"name\":\"Developer Audience\",\"description\":\"Audience for developers\"}")

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

  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "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/audiences/my-favorite-developer-audience', [
  'body' => '{"id":"developer-audience","name":"Developer Audience","description":"Audience for developers"}',
  'headers' => [
    'Accept' => 'application/json',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

200 OK400 Bad Request

{
  "undefined": {
    "undefined": {
      "id": "developer-audience",
      "name": "Developer Audience",
      "description": "Audience for developers",
      "filter": {
        "operator": "EQ",
        "value": "engineer",
        "path": "title"
      }
    }
  }
}

Example

Method: PUT

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

Body:

{
  "id": "abcdefgh12345678",
  "name": "Developer Audience",
  "description": "Audience for developers",
  "filter": {
    "Multiple Filters": {
      "operator": "OR",
      "filters": [
        {
          "operator": "EQ",
          "value": "engineer",
          "path": "title"
        },
        {
          "operator": "EQ",
          "value": "product manager",
          "path": "title"
        }
      ]
    }
  }
}