Subscribe a user(s) to a list

PUThttps://api.courier.com/lists/:list_id/subscriptions

Subscribe multiple recipients to a list (note: if the List does not exist, it will be automatically created)

PATH PARAMS

list_idstringrequired

A unique identifier associated with the list you wish to retrieve.

BODY PARAM

recipientsarray

An array of list subscriptions

Responses

AUTH TOKEN

cURL

curl --request PUT \
     --url https://api.courier.com/lists/example.list.id/subscriptions \
     --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/lists/example.list.id/subscriptions', 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/lists/example.list.id/subscriptions")

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/lists/example.list.id/subscriptions"

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/lists/example.list.id/subscriptions"

  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/lists/example.list.id/subscriptions', [
  'headers' => [
    'Accept' => 'application/json',
  ],
]);

echo $response->getBody();

Response Example

204 Successfully subscribed400 Bad Request

Empty

Example

Method: PUT

URL: https://api.courier.com/lists/abcdefgh12345678/subscriptions

Body: ​

{
  "recipientId": "0460766e-8463-4905-ae98-b72c7aef41d6",
  "preferences": {
    "notifications": {
      "abcdefgh12345678": {
        "channel_preferences": [
          {
            "channel": "direct_message"
          }
        ],
        "rules": [
          {
            "type": "snooze"
          }
        ],
        "status": "OPTED_IN"
      }
    },
    "categories": {
      "cooking": {
        "channel_preferences": [
          {
            "channel": "direct_message"
          }
        ],
        "rules": [
          {
            "type": "snooze"
          }
        ],
        "status": "OPTED_IN"
      }
    }
  }
}