Collections

collections#create - Create a collection

Parameters

Name Description
name required The name of the collection
title required The title of the collection

Request

Route

POST /v1/collections

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer your_access_token
Host: api.producthunt.com

Body

{
  "collection" : {
    "name" : "Awesome Collection #152",
    "title" : "Best new collection ever"
  }
}

Response

Status

201 Created

Headers

X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
X-Rate-Limit-Limit: 900
X-Rate-Limit-Remaining: 900
X-Rate-Limit-Reset: 900
Content-Type: application/json; charset=utf-8
ETag: W/"d45ed48912ba2c175b856075d42b303e"
Cache-Control: max-age=0, private, must-revalidate
Content-Length: 3885

Body

{
  "collection" : {
    "id" : 145,
    "name" : "Awesome Collection #152",
    "title" : "Best new collection ever",
    "created_at" : "2017-07-13T13:31:53.911-07:00",
    "updated_at" : "2017-07-13T13:31:53.911-07:00",
    "featured_at" : null,
    "subscriber_count" : 0,
    "category_id" : null,
    "collection_url" : "http://www.producthunt.com/@producthunter643/collections/awesome-collection-152?utm_campaign=producthunt-api&utm_medium=api&utm_source=Application%3A+Awesome+Oauth+App+%2371+%28ID%3A+21%29",
    "posts_count" : 0,
    "user" : {
      "id" : 168,
      "created_at" : "2017-07-13T13:31:53.859-07:00",
      "name" : "Karl User the 647th",
      "username" : "producthunter643",
      "headline" : "Product Hunter",
      "twitter_username" : "hunter647",
      "website_url" : "http://awesome.io",
      "profile_url" : "http://www.producthunt.com/@producthunter643",
      "image_url" : {
        "30px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=30&h=30",
        "32px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=32&h=32",
        "40px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=40&h=40",
        "44px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=44&h=44",
        "48px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=48&h=48",
        "50px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=50&h=50",
        "60px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=60&h=60",
        "64px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=64&h=64",
        "73px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=73&h=73",
        "80px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=80&h=80",
        "88px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=88&h=88",
        "96px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=96&h=96",
        "100px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=100&h=100",
        "110px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=110&h=110",
        "120px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=120&h=120",
        "132px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=132&h=132",
        "146px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=146&h=146",
        "160px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=160&h=160",
        "176px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=176&h=176",
        "220px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=220&h=220",
        "264px" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=264&h=264",
        "32px@2X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=64&h=64",
        "40px@2X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=80&h=80",
        "44px@2X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=88&h=88",
        "88px@2X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=176&h=176",
        "32px@3X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=96&h=96",
        "40px@3X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=120&h=120",
        "44px@3X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=132&h=132",
        "88px@3X" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=264&h=264",
        "original" : "https://avatars-cdn.producthunt.com/168/original?auto=format&fit=crop&crop=faces&w=original&h=original"
      }
    },
    "background_image_url" : null,
    "color" : "blue",
    "posts" : []
  }
}